Central Memory MCP Server (.NET 10 Azure Functions)

1# Central Memory MCP Server (.NET 10 Azure Functions)
2[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/MWGMorningwood/Central-Memory-MCP)](https://archestra.ai/mcp-catalog/mwgmorningwood__central-memory-mcp)
3 
4Model Context Protocol (MCP) compliant memory & knowledge graph server implemented in .NET 10 (Azure Functions isolated worker). Provides durable project memory (entities, relations, observations) for AI assistants with workspace isolation and simple HTTP tool endpoints.
5 
6## Implemented MCP Tools
7Current function set (alpha stage):
8- read_graph - returns all entities for a workspace (relations currently queried separately and joined)
9- upsert_entity - create or update entity (preserves existing Id if name exists)
10- upsert_relation - create or update relation between two entities (requires GUIDs or resolvable names)
11- get_entity_relations - list relations originating from a specific entity
12- Health & Ready endpoints (/api/health, /api/ready)
13 
14Planned (not yet implemented): search_entities, search_relations, stats, temporal, batch operations, merge/detect duplicates.
15 
16## Data Model
17- Entities table: PartitionKey = WorkspaceName, RowKey = Guid (Id)
18- Relations table: PartitionKey = WorkspaceName, RowKey = Guid (Id)
19- Workspaces table (future expansion)
20 
21Observations stored as a single delimited string ("||") internally; split into List<string> at read time.
22 
23## Quick Start
24```bash
25dotnet restore
26dotnet build
27func start --port 7071
28curl http://localhost:7071/api/health
29```
30To read the graph, invoke the read_graph MCP tool from the client and supply the workspaceName parameter.
31 
32## Directory Layout
33```mermaid
34flowchart TD
35    A[CentralMemoryMcp.Functions]
36    A --> P[Program.cs]
37    A --> SR[ServiceRegistration.cs]
38    A --> F[Functions]
39    F --> GF[GraphFunctions.cs]
40    F --> HF[HealthFunctions.cs]
41    A --> S[Services]
42    S --> KGS[KnowledgeGraphService.cs]
43    A --> ST[Storage]
44    ST --> TSS[TableStorageService.cs]
45    A --> M[Models]
46    M --> GM[GraphModels.cs]
47    A --> CFG[appsettings.json]
48    A --> HOST[host.json]
49```
50 
51## Usage Notes
52- Use workspaceName consistently; workspaceId in docs replaced.
53- Upsert preserves entity identity by lookup on (WorkspaceName + Name).
54- Relation upsert requires entity GUIDs or resolves names; fails if names missing.
55 
56## Logging & Telemetry
57Add Application Insights connection to capture request latency & storage dependency tracking (future enhancement).
58 
59## Roadmap
60Add search, pagination, stats aggregation, batch operations, duplicate detection, merge strategy, semantic vector layer.
61 
62## License
63[MIT](./LICENSE).
64