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。