Central Memory MCP

🚀 中央内存MCP服务器（.NET 10 Azure Functions）

本项目是一个符合模型上下文协议（MCP）的内存与知识图谱服务器，使用 .NET 10（Azure Functions 独立工作进程）实现。它为 AI 助手提供持久的项目内存（实体、关系、观察结果），具备工作区隔离功能和简单的 HTTP 工具端点。

🚀 快速开始

dotnet restore
dotnet build
func start --port 7071
curl http://localhost:7071/api/health

若要读取图谱，可从客户端调用 read_graph MCP 工具，并提供 workspaceName 参数。

✨ 主要特性

已实现的 MCP 工具

当前功能集（Alpha 阶段）：

• read_graph - 返回工作区的所有实体（目前关系需单独查询并合并）
• upsert_entity - 创建或更新实体（若名称已存在，则保留现有 ID）
• upsert_relation - 创建或更新两个实体之间的关系（需要 GUID 或可解析的名称）
• get_entity_relations - 列出源自特定实体的关系
• 健康与就绪端点（/api/health，/api/ready）

计划实现（尚未完成）：search_entities、search_relations、统计信息、时间相关操作、批量操作、合并/检测重复项。

数据模型

• 实体表：分区键 = 工作区名称，行键 = GUID（ID）
• 关系表：分区键 = 工作区名称，行键 = GUID（ID）
• 工作区表（未来扩展）

观察结果在内部存储为单个分隔字符串（"||"）；读取时拆分为 List<string>。

📦 安装指南

按照以下步骤启动项目：

dotnet restore
dotnet build
func start --port 7071
curl http://localhost:7071/api/health

💻 使用示例

基础用法

若要读取图谱，可从客户端调用 read_graph MCP 工具，并提供 workspaceName 参数。

📚 详细文档

目录结构

flowchart TD
    A[CentralMemoryMcp.Functions]
    A --> P[Program.cs]
    A --> SR[ServiceRegistration.cs]
    A --> F[Functions]
    F --> GF[GraphFunctions.cs]
    F --> HF[HealthFunctions.cs]
    A --> S[Services]
    S --> KGS[KnowledgeGraphService.cs]
    A --> ST[Storage]
    ST --> TSS[TableStorageService.cs]
    A --> M[Models]
    M --> GM[GraphModels.cs]
    A --> CFG[appsettings.json]
    A --> HOST[host.json]

使用注意事项

• 始终一致地使用 workspaceName；文档中的 workspaceId 已替换。
• upsert 操作通过（工作区名称 + 名称）查找来保留实体标识。
• 关系 upsert 操作需要实体 GUID 或可解析的名称；若名称缺失则操作失败。

日志记录与遥测

添加 Application Insights 连接以捕获请求延迟和存储依赖跟踪（未来增强功能）。

路线图

添加搜索、分页、统计聚合、批量操作、重复项检测、合并策略、语义向量层。

📄 许可证

MIT。