# GrACE-MCP
**Gr**aphiti + **ACE** **M**odel **C**ontext **P**rotocol Server
一个功能完整的知识图谱 MCP Server，集成 Graphiti 知识图谱和 ACE 自动学习框架，支持通过对话让 AI 主动调用工具完成所有配置和操作。
> **致谢**：本项目基于以下优秀开源项目进行二次开发：
> - [Graphiti](https://github.com/getzep/graphiti) - 知识图谱核心引擎 (Apache 2.0)
> - [ACE (Agentic Context Engine)](https://github.com/kayba-ai/agentic-context-engine) - 自动学习框架 (MIT)
## ✨ 核心特性
- 🗣️ **对话式配置**：通过自然语言对话完成配置，无需手动编辑
- 🤖 **AI 自动调用**：AI 自动学习并调用相应工具
- 🔑 **无需 API Key**：支持使用 MCP Client (如 Cursor, Claude Desktop) 内置 AI 能力
- 📊 **知识图谱**：基于 Neo4j 存储，支持实体和关系管理
- 🔍 **智能搜索**：支持关键词和语义搜索
- 📦 **数据隔离**：支持多项目/多用户数据隔离
- 🧠 **自动学习**：集成 ACE 框架，自适应优化工具调用策略
## 🚀 快速开始
只需两步即可运行：
1. **安装依赖**
```bash
pip install -r requirements.txt
```
2. **配置与连接**
详细的安装、Docker 启动和客户端配置步骤，请参阅 [**快速开始指南 (QUICKSTART.md)**](QUICKSTART.md)。
## 📚 文档
- [**快速开始 (QUICKSTART.md)**](QUICKSTART.md) - **必读**：安装、配置 Neo4j 和连接 MCP Client
- [**使用指南 (USAGE.md)**](USAGE.md) - 功能手册：详细的工具说明和故障排除
- [**示例场景 (EXAMPLES.md)**](EXAMPLES.md) - 最佳实践：12 种实际工作场景演示
- [**Docker 部署 (DOCKER.md)**](DOCKER.md) - Neo4j 容器化部署详解
- [**ACE 策略管理**](USAGE.md#4-ace-自动学习策略) - 自动学习框架集成说明
- [**变更日志 (CHANGELOG.md)**](CHANGELOG.md) - 版本更新记录
## 🛠️ 可用工具概览
本项目提供 **35+ 个 MCP 工具**，涵盖：
- **基础配置** (`configure_neo4j`...)
- **图谱操作** (`add_episode`, `search_entities`...)
- **数据维护** (`export_graph_data`, `health_check`...)
- **ACE 策略** (`query_strategies`, `render_strategy_insights`...)
完整工具列表和参数说明请查阅 [USAGE.md](USAGE.md)。
## 🧪 测试
```bash
# 运行测试
pytest
```
## 🤝 贡献
欢迎提交 Issue 和 PR！详见 [贡献指南 (CONTRIBUTING.md)](CONTRIBUTING.md)。
## 📜 许可证
本项目采用 [MIT 许可证](LICENSE)。
