GrACE-MCP

Graphiti + ACE Model Context Protocol Server

一个功能完整的知识图谱 MCP Server，集成 Graphiti 知识图谱和 ACE 自动学习框架，支持通过对话让 AI 主动调用工具完成所有配置和操作。

致谢：本项目基于以下优秀开源项目进行二次开发：

• Graphiti - 知识图谱核心引擎 (Apache 2.0)
• ACE (Agentic Context Engine) - 自动学习框架 (MIT)

✨ 核心特性

• 🗣️ 对话式配置：通过自然语言对话完成配置，无需手动编辑
• 🤖 AI 自动调用：AI 自动学习并调用相应工具
• 🔑 无需 API Key：支持使用 MCP Client (如 Cursor, Claude Desktop) 内置 AI 能力
• 📊 知识图谱：基于 Neo4j 存储，支持实体和关系管理
• 🔍 智能搜索：支持关键词和语义搜索
• 📦 数据隔离：支持多项目/多用户数据隔离
• 🧠 自动学习：集成 ACE 框架，自适应优化工具调用策略

🚀 快速开始

只需两步即可运行：

1. 安装依赖

   pip install -r requirements.txt
   

2. 配置与连接 详细的安装、Docker 启动和客户端配置步骤，请参阅 快速开始指南 (QUICKSTART.md)。

📚 文档

• 快速开始 (QUICKSTART.md) - 必读：安装、配置 Neo4j 和连接 MCP Client
• 使用指南 (USAGE.md) - 功能手册：详细的工具说明和故障排除
• 示例场景 (EXAMPLES.md) - 最佳实践：12 种实际工作场景演示
• Docker 部署 (DOCKER.md) - Neo4j 容器化部署详解
• ACE 策略管理 - 自动学习框架集成说明
• 变更日志 (CHANGELOG.md) - 版本更新记录

🛠️ 可用工具概览

本项目提供 35+ 个 MCP 工具，涵盖：

• 基础配置 (configure_neo4j...)
• 图谱操作 (add_episode, search_entities...)
• 数据维护 (export_graph_data, health_check...)
• ACE 策略 (query_strategies, render_strategy_insights...)

完整工具列表和参数说明请查阅 USAGE.md。

🧪 测试

# 运行测试
pytest

🤝 贡献

欢迎提交 Issue 和 PR！详见 贡献指南 (CONTRIBUTING.md)。

📜 许可证

本项目采用 MIT 许可证。