Neo4j MCP

🚀 Neo4j MCP 服务器

这是一个基于MCP框架的Neo4j数据库操作服务，可提供便捷的数据库操作功能，支持异步操作和代理服务器配置，还具备完整的日志记录。

🚀 快速开始

本服务是基于MCP框架的Neo4j数据库操作服务，能帮助用户轻松进行Neo4j数据库的相关操作。以下是启动服务并使用的基本步骤：

1. 安装服务（具体安装步骤见下方📦 安装指南）。
2. 完成服务配置（具体配置内容见下方配置说明）。
3. 启动服务器并使用MCP客户端调用服务（具体使用方法见下方💻 使用示例）。

✨ 主要特性

• 支持异步操作，提升操作效率。
• 提供Neo4j数据库的基本操作接口，方便用户进行数据库操作。
• 支持代理服务器配置，满足不同网络环境需求。
• 具备完整的日志记录，便于问题排查和系统监控。

📦 安装指南

使用以下命令进行安装：

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  # 可选

开发

1. 创建虚拟环境

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

2. 安装开发依赖

pip install -e ".[dev]"

3. 运行测试

python -m pytest

💻 使用示例

基础用法

1. 启动服务器

python src/server.py

2. 使用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"})

📄 许可证

本项目采用 MIT 许可证。