https://github.com/MWGMorningwood/Central-Memory-MCP
A custom fork of @modelcontextprotocol/server-memory using Azure Functions MCP triggers and Table storage.
https://github.com/MWGMorningwood/Central-Memory-MCP
Last synced: 2 months ago
JSON representation
A custom fork of @modelcontextprotocol/server-memory using Azure Functions MCP triggers and Table storage.
- Host: GitHub
- URL: https://github.com/MWGMorningwood/Central-Memory-MCP
- Owner: MWGMorningwood
- License: mit
- Created: 2025-07-14T17:26:17.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-08-26T23:50:21.000Z (3 months ago)
- Last Synced: 2025-08-27T07:23:50.286Z (2 months ago)
- Language: TypeScript
- Homepage:
- Size: 176 KB
- Stars: 1
- Watchers: 0
- Forks: 3
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **MWGMorningwood/Central-Memory-MCP 📇 ☁️** - An Azure PaaS-hostable MCP server that provides a workspace-grounded knowledge graph for multiple developers using Azure Functions MCP triggers and Table storage. `http` `azure` `git` `github` (📦 Other)
- awesome-mcp-servers - **MWGMorningwood/Central-Memory-MCP 📇 ☁️** - An Azure PaaS-hostable MCP server that provides a workspace-grounded knowledge graph for multiple developers using Azure Functions MCP triggers and Table storage. `http` `azure` `git` `github` (Other)
README
# 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`](https://github.com/modelcontextprotocol/servers/tree/main/src/memory)
## 🚀 Quick Start
```bash
npm install
func start
```
### VS Code Integration
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.
### Test the Server
```bash
# 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
```
### Example Usage in VS Code Copilot
```text
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"
```
## 🔧 MCP Tools
**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
## 🏗️ Architecture
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
## � Project Structure
```text
src/
├── functions/ # Azure Functions endpoints
├── services/ # Business logic (storage, entities, relations)
├── types/ # TypeScript definitions
└── index.ts # Main entry point
```
## 📚 Documentation
For detailed information, see the `.docs/` folder:
- **[Architecture Guide](.docs/ARCHITECTURE.md)** - Technical design and patterns
- **[API Reference](.docs/API.md)** - Complete endpoint documentation
- **[Storage Guide](.docs/STORAGE.md)** - Storage configuration and workspace management
- **[Deployment Guide](.docs/DEPLOYMENT.md)** - Production deployment options
## 🔒 Production Notes
- 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
## 📝 License
MIT License - see LICENSE file for details.