Context Manager MCP Server

A Model Context Protocol (MCP) server implementation for managing development context and workflow.

Features

• Socket-based transport with reliable message framing
• Full JSON-RPC 2.0 protocol support
• Session management with capability negotiation
• Extensible tool registry system
• Project, workpackage, and task management
• Checkpoint and restore functionality
• QA review workflow support

Initial Setup

# Install dependencies
npm install

# First-time build
npm run build

Usage

Starting the Server

# Development mode (no build required, uses tsx for on-the-fly compilation)
npm run dev

# Production mode (requires build)
npm start

# Start with debug logging
DEBUG=1 npm run dev

# Start on specific port
MCP_PORT=44558 npm run dev

Development Mode

# Run with hot reloading (preferred during development)
npm run dev

# Watch mode for TypeScript compilation (if you prefer running the compiled version)
npm run watch

# In a separate terminal when using watch mode
npm start

Clean Start

If you encounter any issues, you can try a clean build:

# Remove build artifacts
rm -rf dist/

# Reinstall dependencies
npm ci

# Rebuild the project
npm run build

# Start in development mode
npm run dev

Architecture

Core Components

1. Message Framing

   • Content-Length based protocol
   • Reliable message boundary handling
   • Buffer management

2. Transport Layer

   • TCP socket-based communication
   • Connection management
   • Event-driven architecture

3. Session Management

   • Client session tracking
   • Capability negotiation
   • State persistence

4. Tool Registry

   • Dynamic tool registration
   • Input validation
   • Result formatting

Tools

1. Project Management

   • Create/Get projects
   • Project checkpoints
   • State restoration

2. Work Package Management

   • Create/Get work packages
   • Progress tracking
   • Status updates

3. Task Management

   • Create/Update tasks
   • File change tracking
   • Task checkpointing

4. QA Tools

   • Review workflow
   • Fix requests
   • Work package acceptance

Configuration

Environment variables:

• DEBUG: Enable debug logging (0/1)
• MCP_PORT: Server port (default: 44557)

Protocol

The server implements the Model Context Protocol with JSON-RPC 2.0:

interface MCPMessage {
  jsonrpc: "2.0";
  id: number;
  method?: string;      // for requests
  params?: any;         // for requests
  result?: any;         // for responses
  error?: {             // for error responses
    code: number;
    message: string;
    data?: any;
  };
}

Message Flow

1. Client connects via TCP
2. Client sends initialize request
3. Server responds with capabilities
4. Normal message exchange begins
5. Client can shutdown/exit

Development

See Initial Setup and Development Mode sections above.

Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

ISC License