Central Memory MCP Server

Model Context Protocol (MCP) memory server built with Azure Functions and TypeScript, providing persistent knowledge graph storage for AI assistants in VS Code.
Inspired by and forked from @modelcontextprotocol/server-memory

npm install
func start

1. Install recommended extensions from .vscode/extensions.json
2. MCP configuration is ready in .vscode/mcp.json
3. Use #memory-test tools in VS Code Copilot chat

Note: All MCP tools now use object parameters instead of JSON strings for better type safety and ease of use.

# Health check
curl http://localhost:7071/api/health

# Use in VS Code Copilot with object parameters:
# #memory-test_create_entities
# #memory-test_read_graph
# #memory-test_search_entities

Create an entity:
#memory-test_create_entities workspaceId="my-project" entities={"name": "Alice", "entityType": "Person", "observations": ["Software engineer"]}

Create a relation:
#memory-test_create_relations workspaceId="my-project" relations={"from": "Alice", "to": "React Project", "relationType": "worksOn"}

Search entities:
#memory-test_search_entities workspaceId="my-project" name="Alice"

Core Operations:

• create_entities - Create single entity with observations
• create_relations - Create single relationship between entities
• read_graph - Read the entire knowledge graph
• search_entities / search_relations - Search by name/type
• add_observation - Add observations to existing entities
• update_entity - Update entity observations and metadata
• delete_entity - Remove entity and all its relations
• get_stats - Get workspace statistics
• clear_memory - Clear all workspace data

Advanced Features:

• get_temporal_events - Time-based activity tracking
• merge_entities - Merge duplicate entities
• detect_duplicate_entities - Find potential duplicates
• execute_batch_operations - Batch multiple operations
• get_user_stats - Get user-specific statistics
• search_relations_by_user - Find relations by user

Built with:

• Azure Functions v4 with TypeScript
• Azure Table Storage for persistent data (via Azurite locally)
• Model Context Protocol (MCP) for VS Code integration
• Workspace isolation - each project gets separate storage

src/
├── functions/         # Azure Functions endpoints
├── services/          # Business logic (storage, entities, relations)
├── types/             # TypeScript definitions
└── index.ts           # Main entry point

For detailed information, see the .docs/ folder:

• Architecture Guide - Technical design and patterns
• API Reference - Complete endpoint documentation
• Storage Guide - Storage configuration and workspace management
• Deployment Guide - Production deployment options

• Uses Azure Table Storage with managed identity for security
• Workspace isolation prevents data leakage between projects
• Health endpoints for monitoring and container orchestration
• Automatic fallback to local storage for development

MIT License - see LICENSE file for details.