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 框架，自适应优化工具调用策略
🚀 快速开始
只需两步即可运行：
-
安装依赖
pip install -r requirements.txt -
配置与连接 详细的安装、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 许可证。