Neo4j Mcpserver

🚀 Neo4j MCP 服務器

Neo4j MCP 服務器用於通過模型上下文協議管理圖數據庫操作，並且🔌 兼容 Cursor 和桌面版 Claude！

🚀 快速開始

你可以直接使用 npx 運行服務器：

# 使用單個連接字符串
NEO4J_CONNECTION=neo4j+s://your-instance.databases.neo4j.io,neo4j,your-password npx neo4j-mcpserver

# 或者使用單獨的環境變量
NEO4J_URI=neo4j+s://your-instance.databases.neo4j.io NEO4J_USER=neo4j NEO4J_PASSWORD=your-password npx neo4j-mcpserver

📦 安裝指南

如果你更願意全局安裝：

npm install -g neo4j-mcpserver

然後運行它：

NEO4J_CONNECTION=neo4j+s://your-instance.databases.neo4j.io,neo4j,your-password neo4j-mcpserver

📚 詳細文檔

環境變量

你可以通過以下兩種方式提供 Neo4j 的連接信息：

1. 使用單個連接字符串：

   NEO4J_CONNECTION=<uri>,<user>,<password>
   

2. 使用單獨的環境變量：

   NEO4J_URI=<your-uri>
   NEO4J_USER=<your-user>
   NEO4J_PASSWORD=<your-password>
   

你還可以在項目根目錄中使用一個 .env 文件：

NEO4J_URI=neo4j+s://your-instance.databases.neo4j.io
NEO4J_USER=neo4j
NEO4J_PASSWORD=your-password

配置 ⚙️

在 Cursor 中配置 🖥️

要在 Cursor 中設置 Neo4j MCP 服務器：

1. 打開 Cursor 設置
2. 點擊功能 > MCP 服務器
3. 點擊“+ 添加新 MCP 服務器”按鈕
4. 填寫以下信息：
   • 名稱：輸入一個服務器的暱稱（例如，“neo4j-mcp”）
   • 類型：選擇“命令”作為類型
   • 命令：輸入運行服務器的命令：

     env=NEO4J_URI=your-neo4j-uri,NEO4J_USER=your-neo4j-user,NEO4J_PASSWORD=your-neo4j-password npx -y @neobarrientos/neo4j_mcpserver
     

   注意：用你的實際 Neo4j 數據庫憑證替換憑據。

可用工具 🛠️

neo4j-query

對你的 Neo4j 數據庫執行 Cypher 查詢。

在 Cursor 中的示例使用：

MATCH (n) RETURN n LIMIT 5

故障排除 🔧

如果你遇到問題：

1. 驗證 Neo4j 憑據

   • 檢查你的 Neo4j URI、用戶名和密碼是否正確
   • 確保你的 Neo4j 數據庫可以訪問

2. 路徑問題

   • 確保安裝路徑中沒有空格
   • 使用正斜槓 (/) 在路徑中

3. 工具檢測問題

   • 嘗試重新啟動 Cursor
   • 驗證服務器是否運行（檢查 Cursor 的 MCP 服務器列表）
   • 確認環境變量已正確設置

開發 👩💻

從倉庫克隆項目後，按照以下步驟進行開發：

1. 克隆倉庫：

   git clone [倉庫地址]
   cd [項目目錄]
   

2. 安裝依賴項：

   npm install
   

3. 啟動服務器：

   npm start
   

4. 運行測試：

   npm test
   

📄 許可證

MIT License

版權所有 (c) [年份] [作者姓名]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.