Central Memory MCP

🚀 セントラルメモリMCPサーバー (.NET 10 Azure Functions)

Model Context Protocol (MCP)に準拠したメモリと知識グラフサーバーで、.NET 10 (Azure Functions isolated worker)で実装されています。ワークスペースの分離とシンプルなHTTPツールエンドポイントを備え、AIアシスタントに耐久性のあるプロジェクトメモリ（エンティティ、関係、観測値）を提供します。

🚀 クイックスタート

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

グラフを読み取るには、クライアントからread_graph MCPツールを呼び出し、workspaceNameパラメーターを指定します。

✨ 主な機能

実装済みのMCPツール

現在の機能セット（アルファ段階）:

• read_graph - ワークスペースのすべてのエンティティを返します（関係は現在別途クエリされ、結合されます）
• upsert_entity - エンティティを作成または更新します（名前が存在する場合は既存のIDを保持します）
• upsert_relation - 2つのエンティティ間の関係を作成または更新します（GUIDまたは解決可能な名前が必要です）
• get_entity_relations - 特定のエンティティから始まる関係のリストを表示します
• ヘルスチェックと準備完了エンドポイント (/api/health, /api/ready)

計画中（未実装）: search_entities、search_relations、stats、temporal、バッチ操作、重複検出とマージ。

📚 ドキュメント

データモデル

• エンティティテーブル: PartitionKey = WorkspaceName, RowKey = Guid (Id)
• 関係テーブル: PartitionKey = WorkspaceName, RowKey = Guid (Id)
• ワークスペーステーブル（将来的な拡張）

観測値は内部的に単一の区切り文字列 ("||") として保存されます。読み取り時にListに分割されます。

ディレクトリ構成

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は (WorkspaceName + Name) でのルックアップによりエンティティの同一性を保持します。
• 関係のupsertにはエンティティのGUIDまたは解決可能な名前が必要です。名前が欠落している場合は失敗します。

ロギングとテレメトリ

リクエストのレイテンシとストレージの依存関係の追跡をキャプチャするには、Application Insightsの接続を追加してください（将来的な機能強化）。

ロードマップ

検索、ページネーション、統計集計、バッチ操作、重複検出、マージ戦略、セマンティックベクトル層を追加します。

📄 ライセンス

MIT