Magic Garden Neo4j Server

魔术花园Neo4j MCP服务器

一个用于Neo4j图形数据库操作的模型上下文协议（MCP）服务器，专为Magic Garden AI儿童教育平台设计。

特性

已实施的工具（26/64-完成40%）

用户管理（5个工具）

• user_create -使用密码哈希创建新用户帐户
• user_authenticate -对用户进行身份验证并生成令牌
• user_profile_get -获取包含统计信息的用户配置文件
• user_update -更新用户信息
• user_delete -使用级联选项删除用户

记录管理（5个工具）

• record_create -使用向量嵌入创建记录
• record_update -更新记录属性
• record_search -带分页的多条件搜索
• record_similarity_search -向量相似性搜索
• record_batch_operation -带有交易的批处理操作

会话管理（7个工具）

• conversation_create -创建新对话
• conversation_update -更新对话元数据
• message_create -在对话中添加消息
• message_update -更新消息内容
• conversation_history_get -检索对话历史记录
• conversation_search -使用过滤器搜索对话
• conversation_analysis -分析对话模式

安装

# Clone the repository
git clone https://github.com/yourusername/magic-garden-neo4j-server.git
cd magic-garden-neo4j-server

# Install dependencies
pip install -r requirements.txt

配置

环境变量

创建一个 .env 文件包含：

NEO4J_URI=bolt://localhost:7687
NEO4J_USER=neo4j
NEO4J_PASSWORD=your-password
NEO4J_DATABASE=neo4j
LOG_LEVEL=INFO

Claude桌面配置

添加到Claude桌面设置：

{
  "mcpServers": {
    "magic-garden-neo4j": {
      "command": "python",
      "args": ["-m", "magic_garden_neo4j_server"],
      "cwd": "/path/to/magic-garden-neo4j-server",
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USER": "neo4j",
        "NEO4J_PASSWORD": "your-password"
      }
    }
  }
}

光标配置

对于Cursor IDE集成，请添加到 .cursor/mcp-settings.json:

{
  "servers": [
    {
      "name": "magic-garden-neo4j",
      "command": "python",
      "args": ["-m", "magic_garden_neo4j_server"],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USER": "neo4j",
        "NEO4J_PASSWORD": "your-password"
      }
    }
  ]
}

用法

启动服务器

# Direct execution
python -m magic_garden_neo4j_server

# With environment variables
NEO4J_URI=bolt://localhost:7687 python -m magic_garden_neo4j_server

工具使用示例

创建用户

{
  "tool": "user_create",
  "arguments": {
    "username": "alice",
    "password": "secure123",
    "nickname": "Alice",
    "age": 8
  }
}

创建记录

{
  "tool": "record_create",
  "arguments": {
    "user_id": "user_abc123",
    "title": "My Drawing",
    "image_url": "https://example.com/image.jpg",
    "mood_color": "happy_yellow",
    "embedding": [0.1, 0.2, 0.3, ...]
  }
}

开始对话

{
  "tool": "conversation_create",
  "arguments": {
    "user_id": "user_abc123",
    "title": "Story Time",
    "conversation_type": "story"
  }
}

建筑

magic-garden-neo4j-server/
├── src/
│   ├── __init__.py
│   ├── server.py           # MCP server implementation
│   ├── neo4j_manager.py    # Neo4j connection management
│   ├── tool_registry.py    # Tool registration system
│   ├── tools/
│   │   ├── base.py         # Base tool class
│   │   ├── user_tools.py   # User management tools
│   │   ├── record_tools.py # Record management tools
│   │   ├── conversation_tools.py # Conversation tools
│   │   └── ...             # Other tool modules
│   └── utils/
│       ├── errors.py       # Error handling
│       ├── logger.py       # Logging configuration
│       └── validators.py   # Input validation
├── requirements.txt
├── README.md
└── .env.example

开发状态

已完成（40%）

• ✅ 核心基础设施（8项任务）
• ✅ 用户管理（5个工具）
• ✅ 记录管理（5个工具）
• ✅ 会话管理（7个工具）

进行中（60%）

• 🚧 智能分析工具（7个工具）
• 🚧 矢量服务工具（7个工具）
• 🚧 报告生成工具（7个工具）
• 🚧 高级查询工具（7个工具）
• 🚧 交易管理工具（7个工具）

许可证

麻省理工学院

贡献

欢迎拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。

支持

有关问题和疑问，请在GitHub上打开问题。