Neo4j FastMCP Server with Descope Authentication

by artur-nohup

176 downloads Not rated yet MIT license

GitHub

Developer Tools

About

Neo4j MCP Server built with FastMCP TypeScript framework, featuring OAuth authentication and Docker support

Details

License: MIT license

Explore

- 🔐 Enterprise Authentication: OAuth 2.1 with PKCE + API key authentication via Descope
- 🎯 Claude.ai Ready: Full OAuth flow integration for Claude's custom integrations
- 🧠 Neo4j Knowledge Graph: Persistent memory storage with full-text search
- 🛡️ Fine-grained Permissions: MCP-specific scopes and role-based access control
- 📊 Session Management: Automatic token refresh and session validation
- 🐳 Production Ready: Docker support with health checks and monitoring
- ⚡ FastMCP Framework: Built on the latest FastMCP TypeScript framework

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Neo4j FastMCP Server with Descope Authentication

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "neo4j fastmcp server with descope authentication": {
            "neo4j-fastmcp-server": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "neo4j fastmcp server with descope authentication": {
            "neo4j-fastmcp-server": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "neo4j fastmcp server with descope authentication": {
            "neo4j-fastmcp-server": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "neo4j fastmcp server with descope authentication": {
            "neo4j-fastmcp-server": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "neo4j fastmcp server with descope authentication": {
            "neo4j-fastmcp-server": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "neo4j fastmcp server with descope authentication": {
            "neo4j-fastmcp-server": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "neo4j fastmcp server with descope authentication": {
            "neo4j-fastmcp-server": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "neo4j fastmcp server with descope authentication": {
            "neo4j-fastmcp-server": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "neo4j fastmcp server with descope authentication": {
            "neo4j-fastmcp-server": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "neo4j fastmcp server with descope authentication": {
            "neo4j-fastmcp-server": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "neo4j fastmcp server with descope authentication": {
            "neo4j-fastmcp-server": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "neo4j fastmcp server with descope authentication": {
            "neo4j-fastmcp-server": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "neo4j fastmcp server with descope authentication": {
            "neo4j-fastmcp-server": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "neo4j fastmcp server with descope authentication": {
            "neo4j-fastmcp-server": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "neo4j fastmcp server with descope authentication": {
            "neo4j-fastmcp-server": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

From the repository

A production-ready remote Model Context Protocol (MCP) server with enterprise-grade authentication powered by Descope. Fully compatible with Claude.ai and other MCP clients.

git clone https://github.com/artur-nohup/neo4j-fastmcp-server.git
cd neo4j-fastmcp-server
npm install
cp .env.example .env

Edit .env with your configuration:

DESCOPE_PROJECT_ID=your-descope-project-id DESCOPE_MANAGEMENT_KEY=your-management-key NEO4J_URI=bolt://localhost:7687 NEO4J_USERNAME=neo4j NEO4J_PASSWORD=your-password OAUTH_CLIENT_ID=your-oauth-client-id OAUTH_CLIENT_SECRET=your-oauth-client-secret OAUTH_REDIRECT_URI=http://localhost:8081/oauth/callback Ideal for programmatic access and automation:

bash

1. create_entities - Create knowledge graph entities
2. create_relations - Create relationships between entities
3. add_observations - Add observations to entities
4. delete_entities - Remove entities and relations
5. delete_observations - Remove specific observations
6. delete_relations - Remove relationships
7. read_graph - Read entire knowledge graph
8. search_nodes - Full-text search across the graph
9. find_nodes - Find specific entities by name
10. health_check - Server and Neo4j health status

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "neo4j fastmcp server with descope authentication": {
            "neo4j-fastmcp-server": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

McpServers

{
    "neo4j-fastmcp-server": {
        "command": "npx",
        "args": [
            "@modelcontextprotocol/inspector"
        ]
    }
}

A production-ready remote Model Context Protocol (MCP) server with enterprise-grade authentication powered by Descope. Fully compatible with Claude.ai and other MCP clients.

🚀 Features

🎯 Perfect for Claude.ai Integration

This server is specifically designed to work with Claude.ai's custom integrations feature:

1. OAuth 2.1 Compliance: Full PKCE support for secure authentication
2. Remote MCP Protocol: HTTP streaming transport for cloud deployment
3. Scope-based Permissions: Fine-grained access control
4. Session Management: Automatic token handling and refresh
5. Production Security: Enterprise-grade authentication via Descope

🚀 Quick Start

1. Clone and Setup

git clone https://github.com/artur-nohup/neo4j-fastmcp-server.git
cd neo4j-fastmcp-server
npm install
cp .env.example .env

2. Configure Environment

Edit .env with your configuration:

```env

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Explore

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

🚀 Features

🎯 Perfect for Claude.ai Integration

🚀 Quick Start

1. Clone and Setup

2. Configure Environment

More like this

Sentry

Github

Git

GitLab