Neo4j Server

neo4j-server-remote

neo4j-server-remote é um servidor MCP que usa Server-Sent Events (SSE) ou STDIO como protocolo de transporte.

Visão Geral

Uma implementação de servidor Model Context Protocol (MCP) que fornece interação com banco de dados e permite capacidades de exploração de grafos por meio do Neo4j. Este servidor permite a execução de consultas Cypher em grafos, análise de dados de domínio complexos e suporta a seleção de bancos de dados acessíveis remotamente. Inspirado em neo4j-contrib/mcp-neo4j.

Prompts

O servidor fornece um prompt de demonstração:

• mcp-demo: Prompt interativo que orienta os usuários pelas operações do banco de dados
  • Gera esquemas de banco de dados e dados de exemplo apropriados

Ferramentas

O servidor oferece três ferramentas principais:

Ferramentas de Consulta

• read-neo4j-cypher

  • Executa consultas Cypher de leitura para ler dados do banco de dados
  • Entrada:
    • query (string): A consulta Cypher a ser executada
  • Retorna: Resultados da consulta como uma matriz de objetos

• write-neo4j-cypher

  • Executa consultas Cypher de atualização
  • Entrada:
    • query (string): A consulta Cypher de atualização
  • Retorna: um contador de resumo de resultados com { nodes_updated: number, relationships_created: number, ... }

Ferramentas de Esquema

• get-neo4j-schema
  • Obtém uma lista de todos os tipos de nós no banco de dados de grafos, seus atributos com nome, tipo e relacionamentos com outros tipos de nós
  • Nenhuma entrada necessária
  • Retorna: Lista de rótulos de nós com dois dicionários, um para atributos e outro para relacionamentos

Uso com o cliente Cline

1.Clone o repositório

git clone https://github.com/dsimile/mcp-neo4j-server-sse.git

2.Instale os requisitos

• Python 3.12+

cd mcp-neo4j-server-sse

pip install -r requirements.txt

3.Execute o servidor

• Modo SSE (padrão)

Execute o servidor MCP usando o comando UX e selecione o banco de dados de sua escolha. O endereço IP padrão é 0.0.0.0 e a porta padrão é 8543.

uv run .\src\mcp-neo4j-cypher\neo4j_server_remote.py --url bolt://localhost:7687 --username neo4j --password neo4j123 --database neo4j

• Modo STDIO

Execute o servidor MCP localmente usando o comando UX com o modo definido como STDIO e as mesmas informações de conexão do Neo4j.

Nota: Certifique-se de que o Neo4j esteja em execução e acessível para conexões remotas.

Pacote Publicado

Adicione a configuração do servidor ao seu cline_mcp_settings.json.

• Modo SSE (padrão)

{
  "mcpServers": {
    "neo4j-remote": {
      "url": "http://0.0.0.0:8543/sse",
      "disabled": false,
      "autoApprove": []
    }
  }
}

• Modo STDIO

{
  "mcpServers": {
    "neo4j-local": {
      "disabled": false,
      "timeout": 60,
      "command": "uv",
      "args": [
        "run",
        "/absolute/path/to/neo4j_server_remote.py",
        "--url",
        "bolt://localhost:7687",
        "--username",
        "neo4j",
        "--password",
        "neo4j123",
        "--database",
        "neo4j",
        "--mode",
        "stdio"
      ]
    }
  }
}

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.