Neo4j MCP

🚀 Neo4j MCP 服務器

Neo4j MCP 服務器是一個基於 MCP 框架構建的服務，專注於提供對 Neo4j 數據庫的高效操作。它為開發者提供了便捷的接口，能夠輕鬆實現對 Neo4j 數據庫的各類操作，同時支持異步處理和代理配置，極大地提升了開發效率和靈活性。

🚀 快速開始

Neo4j MCP 服務器的使用非常簡單，只需按照以下步驟操作，即可快速啟動並使用該服務。

安裝

pip install -e .

配置

創建 .env 文件並設置以下環境變量：

NEO4J_URI=http://your-neo4j-server:7474
NEO4J_USERNAME=neo4j
NEO4J_PASSWORD=your-password
HTTP_PROXY=http://your-proxy:port  # 可選
HTTPS_PROXY=http://your-proxy:port  # 可選

啟動服務

python src/server.py

使用 MCP 客戶端調用服務

from mcp.client import Client

async with Client() as client:
    # 執行 Cypher 查詢
    result = await client.execute_query("MATCH (n) RETURN n LIMIT 5")
    
    # 創建節點
    node = await client.create_node("Person", {"name": "張三", "age": 30})
    
    # 創建關係
    rel = await client.create_relationship(1, 2, "KNOWS", {"since": "2024"})

✨ 主要特性

• 異步操作支持：支持異步操作，提升系統響應速度和併發處理能力。
• 基本操作接口：提供 Neo4j 數據庫的基本操作接口，方便開發者進行數據的增刪改查。
• 代理服務器配置：支持代理服務器配置，可靈活應對不同的網絡環境。
• 完整日誌記錄：具備完整的日誌記錄功能，方便問題排查和系統監控。

📦 安裝指南

pip install -e .

💻 使用示例

基礎用法

from mcp.client import Client

async with Client() as client:
    # 執行 Cypher 查詢
    result = await client.execute_query("MATCH (n) RETURN n LIMIT 5")
    
    # 創建節點
    node = await client.create_node("Person", {"name": "張三", "age": 30})
    
    # 創建關係
    rel = await client.create_relationship(1, 2, "KNOWS", {"since": "2024"})

開發流程

創建虛擬環境

python -m venv .venv
source .venv/bin/activate  # Linux/Mac
.venv\Scripts\activate  # Windows

安裝開發依賴

pip install -e ".[dev]"

運行測試

python -m pytest

📄 許可證

本項目採用 MIT 許可證。