MCP Neo4j Graphrag

🚀 Neo4j GraphRAG MCP 服務器

這是一個 MCP 服務器，它為 Neo4j 增添了向量搜索、全文搜索以及適用於 GraphRAG 應用程序的搜索增強型 Cypher 查詢功能。

靈感來源：Neo4j Labs mcp-neo4j-cypher 服務器。此服務器增加了向量搜索、全文搜索以及創新的 search_cypher_query 工具，用於將搜索與圖遍歷相結合。

🚀 快速開始

本服務器使大語言模型（LLMs）能夠：

• 🔍 使用語義相似度搜索 Neo4j 向量索引。
• 📝 使用 Lucene 語法搜索全文索引。
• ⚡ 通過 search_cypher_query 將搜索與 Cypher 查詢相結合。
• 🕸️ 執行只讀 Cypher 查詢。

它基於 LiteLLM 構建，支持多供應商嵌入（如 OpenAI、Azure、Bedrock、Cohere 等）。

相關鏈接：官方 Neo4j MCP 服務器，請參閱 neo4j/mcp。Neo4j Labs MCP 服務器（Cypher、內存、數據建模），請參閱 neo4j-contrib/mcp-neo4j。

📦 安裝指南

步驟 1：下載倉庫

git clone https://github.com/guerinjeanmarc/mcp-neo4j-graphrag.git
cd mcp-neo4j-graphrag

步驟 2：配置你的 MCP 客戶端

Claude Desktop

編輯配置文件：

• macOS/Linux：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

添加此服務器配置（更新為你克隆倉庫的路徑）：

{
  "mcpServers": {
    "neo4j-graphrag": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-neo4j-graphrag",
        "run",
        "mcp-neo4j-graphrag"
      ],
      "env": {
        "NEO4J_URI": "neo4j+s://demo.neo4jlabs.com",
        "NEO4J_USERNAME": "recommendations",
        "NEO4J_PASSWORD": "recommendations",
        "NEO4J_DATABASE": "recommendations",
        "OPENAI_API_KEY": "sk-...",
        "EMBEDDING_MODEL": "text-embedding-ada-002"
      }
    }
  }
}

Cursor

在你的項目或全局設置中編輯 .cursor/mcp.json。使用與上述相同的配置。

步驟 3：重新加載配置

• Claude Desktop：退出並重新啟動應用程序。
• Cursor：重新加載窗口（Cmd/Ctrl + Shift + P → "重新加載窗口"）。

✨ 主要特性

get_neo4j_schema_and_indexes

發現圖模式、向量索引和全文索引。 💡 代理在使用其他工具之前，應首先自動調用此工具，以瞭解數據庫的模式和索引。

示例提示：

"數據庫中有什麼？"

vector_search

使用嵌入進行語義相似度搜索。

參數：text_query、vector_index、top_k、return_properties

示例提示：

"有哪些關於人工智能的電影？"

fulltext_search

使用 Lucene 語法（AND、OR、通配符、模糊匹配）進行關鍵字搜索。

參數：text_query、fulltext_index、top_k、return_properties

示例提示：

"查找名為 Tom 的人"

read_neo4j_cypher

執行只讀 Cypher 查詢。

參數：query、params

示例提示：

"給我展示所有類型以及每種類型中有多少部電影"

search_cypher_query

將向量/全文搜索與 Cypher 查詢相結合。使用 $vector_embedding 和 $fulltext_text 佔位符。

參數：cypher_query、vector_query、fulltext_query、params

示例提示：

"在一個查詢中，關於'時間旅行冒險'的電影的導演和類型有哪些"

📚 詳細文檔

環境變量

嵌入供應商

設置 EMBEDDING_MODEL 和相應的 API 密鑰：

高級主題

有關以下內容，請參閱 docs/ADVANCED.md：

• 與 Neo4j Labs mcp-neo4j-cypher 服務器的比較。
• 生產特性（輸出清理、令牌限制）。
• 詳細的工具文檔。

📄 許可證

本項目採用 MIT 許可證。