MCP for Neo4j

Conecta-se a bancos de dados gráficos Neo4j com capacidade de usar funções GDS (quando disponíveis), um modo somente leitura e definir o tamanho da amostra para detecção de esquema.

Documentação

Neo4j MCP

O Neo4j MCP oferece a assistentes de IA e ferramentas baseadas em LLM acesso direto e estruturado ao seu banco de dados de grafos Neo4j. Ao implementar o Model Context Protocol (MCP), ele atua como uma ponte entre qualquer cliente compatível com MCP, como Claude, Cursor ou VS Code com suporte a MCP, e sua instância Neo4j.

Recursos

  • Explore o esquema do seu grafo - descubra rótulos de nós, tipos de relacionamento e chaves de propriedades
  • Permita que a IA raciocine sobre seu modelo de dados sem conhecimento prévio
  • Execute consultas Cypher - execute, leia e escreva consultas no seu banco de dados em resposta a prompts em linguagem natural
  • Inspecione e analise dados - recupere nós, relacionamentos e caminhos para responder perguntas, gerar resumos ou alimentar outros fluxos de trabalho

Ferramentas

  • get-schema — inspecione rótulos, tipos de relacionamento, chaves de propriedades
  • read-cypher — execute consultas Cypher somente leitura que não modificam os dados do banco, aplicado via EXPLAIN e a classificação de tipo de consulta do Neo4j. Nota: procedimentos ou funções personalizados classificados incorretamente como somente leitura pelo Neo4j podem contornar essa verificação; garantir a classificação correta é responsabilidade do mantenedor do procedimento/função.
  • write-cypher — execute consultas Cypher de escrita (desabilitado se NEO4J_MCP_READ_ONLY=true)
  • list-gds-procedures — liste os procedimentos GDS disponíveis

Instalação

Instale com PyPI:

pip install neo4j-mcp-server

Caso contrário, veja Documentação do MCP -> Instalação.

Configuração do servidor (VSCode)

Crie / edite mcp.json:

{
  "servers": {
    "neo4j": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "neo4j_mcp_server"],
      "env": {
        "NEO4J_MCP_URI": "bolt://localhost:7687",
        "NEO4J_MCP_USERNAME": "neo4j",
        "NEO4J_MCP_PASSWORD": "password",
        "NEO4J_MCP_DATABASE": "neo4j",
        "NEO4J_MCP_READ_ONLY": "true",
        "NEO4J_MCP_TELEMETRY": "false",
        "NEO4J_MCP_LOG_LEVEL": "info",
        "NEO4J_MCP_LOG_FORMAT": "text",
        "NEO4J_MCP_SCHEMA_SAMPLE_SIZE": "100"
      }
    }
  }
}

Veja Documentação do MCP > Configuração para mais detalhes.

Links

Para problemas e feedback, você também pode criar uma issue no GitHub com detalhes de reprodução (omita dados sensíveis).