Neo4j FastMCP Server with Descope Authentication

by artur-nohup

176 downloads

Not rated

GitHub

Developer Tools

About

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

Details

Author: artur-nohup
Downloads: 176
Categories: Developer Tools

- Enterprise authentication: OAuth 2.1 with PKCE + API keys
- Full OAuth flow integration for Claude.ai custom integrations
- Persistent Neo4j knowledge graph with full-text search
- Fine-grained permissions with MCP-specific scopes and RBAC
- Automatic token refresh and session validation
- Docker support with health checks and monitoring

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

Clone the repository, install dependencies (npm install), configure the .env file with Descope, Neo4j, and OAuth credentials, then start with npm run dev (port 8081 for MCP, 8082 for OAuth). For Claude.ai, add a custom integration pointing to the MCP server URL and complete the OAuth flow. Docker deployments use docker run with environment variables or docker compose up -d.

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"
        ]
    }
}

Neo4j FastMCP Server with Descope Authentication

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

- 🔐 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

🎯 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.

Neo4j FastMCP Server with Descope Authentication

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

Claude Desktop / Cursor

McpServers

Neo4j FastMCP Server with Descope Authentication

🚀 Features

🎯 Perfect for Claude.ai Integration

🚀 Quick Start

1. Clone and Setup

2. Configure Environment

Install

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Neo4j FastMCP Server with Descope Authentication

🚀 Features

🎯 Perfect for Claude.ai Integration

🚀 Quick Start

1. Clone and Setup

2. Configure Environment

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright