Claude Server MCP

⚠️ IMPORTANT: Project Status ⚠️
This project is in early development (v0.1.0) and is NOT READY FOR PRODUCTION USE. It is currently undergoing a significant rewrite to address several critical issues. Please check the Issues page for current limitations and planned improvements.
We recommend waiting for a stable release (v0.2.0+) before using this in any critical workflows.

A Model Context Protocol (MCP) server that provides sophisticated context management capabilities for Claude, enabling persistent context across sessions, project-specific context organization, and conversation continuity.

Current Limitations

The server currently has compatibility issues with MCP clients other than Claude Desktop
Context listing functionality is limited without specific project IDs
Security features are minimal and not production-ready
Error handling is basic and may not provide helpful guidance
No testing infrastructure is in place

Development Roadmap

This project is actively being improved. Key upcoming enhancements include:

Stability Improvements - Fixing core issues with home directory resolution and context listing
Enhanced Error Handling - Better error messages and recovery mechanisms
Security Enhancements - Input validation, path sanitization, and data protection
Advanced Context Management - Versioning, search, and better organization

For a more detailed roadmap, see our Comprehensive Analysis branch.

Features

Project Context Management
- Hierarchical context organization
- Parent-child relationships
- Cross-referencing between contexts
- Project-specific metadata
Conversation Continuity
- Session-based context tracking
- Conversation chaining
- Metadata-rich context storage
- Flexible tagging system
Efficient Storage
- Organized directory structure
- JSON-based storage
- Quick lookup indexing
- Asynchronous operations

Installation

The server is automatically configured in your Claude desktop app's MCP settings. All contexts are stored in ~/.claude/ for better organization:

~/.claude/
├── contexts/           # General conversation contexts
├── projects/          # Project-specific contexts
└── context-index.json # Quick lookup index

Tools

Project Context Management

// Save project context
use_mcp_tool({
  server_name: "claude-server",
  tool_name: "save_project_context",
  arguments: {
    id: "feature-design-v1",
    projectId: "my-project",
    content: "Design discussion...",
    parentContextId: "requirements-v1",
    references: ["api-spec-v1"],
    tags: ["design"],
    metadata: { status: "in-progress" }
  }
});

Conversation Management

// Save conversation context
use_mcp_tool({
  server_name: "claude-server",
  tool_name: "save_conversation_context",
  arguments: {
    id: "chat-2024-01-01",
    sessionId: "session-123",
    content: "Discussion content...",
    continuationOf: "previous-chat-id",
    tags: ["meeting"]
  }
});

Context Retrieval

// Get context
use_mcp_tool({
  server_name: "claude-server",
  tool_name: "get_context",
  arguments: {
    id: "feature-design-v1",
    projectId: "my-project"
  }
});

// List contexts
use_mcp_tool({
  server_name: "claude-server",
  tool_name: "list_contexts",
  arguments: {
    projectId: "my-project",
    tag: "design",
    type: "project"
  }
});

Documentation

Context Management Guide - Detailed guide on context types and usage
Architecture Overview - Technical implementation details
Usage Guide - General usage instructions
Claude Desktop Integration - Integration with Claude Desktop

Development

Clone the repository
Install dependencies:
npm install
Build the server:
npm run build
The server will be built to build/index.js

Configuration

The server is configured through the Claude desktop app's configuration file at: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "claude-server": {
      "command": "node",
      "args": ["/path/to/claude-server/build/index.js"]
    }
  }
}

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

License

MIT

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Provides sophisticated context management for Claude, enabling persistent context across sessions, project-specific organization, and conversation continuity.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Development Server
dillip285
-
security
F
license
-
quality
A Model Context Protocol server that enables Claude to manage software development projects with complete context awareness and code execution through Docker environments.
Last updated -
1
Python
MCP Memory Server
ebailey78
-
security
F
license
-
quality
A Model Context Protocol server for Claude Desktop that provides structured memory management across chat sessions, allowing Claude to maintain context and build a knowledge base within project directories.
Last updated -
TypeScript
Backlog MCP Server
katsuhirohonda
-
security
F
license
-
quality
Integrates Backlog project management with Claude via Model Context Protocol, enabling access to projects, issues, and wiki pages through natural language interactions.
Last updated -
TypeScript
Developer MCP Server
tejpalvirk
-
security
F
license
-
quality
A powerful context management system that maintains persistent context across coding sessions, helping development teams track project structure, dependencies, and progress.
Last updated -
TypeScript

View all related MCP servers

Claude Server MCP