Tracks Docker as part of the technology stack for projects, allowing it to be specified during project creation and maintained in the project context
Supports Next.js as a frontend technology option, allowing it to be specified during project creation and maintained in the project context
Supports Node.js as a backend technology option, allowing it to be specified during project creation and maintained in the project context
Supports PostgreSQL as a database technology option, allowing it to be specified during project creation and maintained in the project context
Supports recording architectural decisions about using Prisma as an ORM, tracking it as part of the technology choices
MCP Project Context Server
A Model Context Protocol (MCP) server that provides persistent project context and planning state between Claude Code sessions. This eliminates the need to re-explain project details, current status, and development context every time you start a new coding session.
What It Does
The MCP Project Context Server acts as a persistent memory layer for your development projects, maintaining:
Project Information: Name, description, current phase, and status
Technology Stack: Frontend, backend, database, infrastructure, and tooling choices
Task Management: Development tasks with priorities, status tracking, and dependencies
Decision History: Architectural and technical decisions with reasoning
Session Continuity: Goals, achievements, and blockers from previous sessions
Development Notes: Important observations and insights
How It Works
The server implements the Model Context Protocol to provide Claude Code with tools for managing project context:
Project Creation: Initialize new projects with tech stack and current phase
Context Retrieval: Get comprehensive project state and history
Task Management: Create, update, and track development tasks
Decision Recording: Document important technical and architectural decisions
Session Tracking: Maintain continuity between development sessions
Note Taking: Capture important insights and observations
Data is stored as JSON files in a local data
directory, making it easy to backup, version control, or inspect manually.
Key Features
Persistent Context: Project state survives between Claude Code sessions
Technology Stack Awareness: Tracks your preferred technologies and tools
Task Prioritization: Organize work with priority levels and status tracking
Decision Documentation: Maintain architectural decision records (ADRs)
Session Goals: Track what you planned vs what you achieved
File-Based Storage: Simple JSON storage that's easy to understand and backup
Prerequisites
Node.js 18 or higher
pnpm package manager
Claude Code CLI tool
Installation
Clone and setup the project:
Build the server:
Make the server executable:
Configuration
Claude Code Setup
Create or edit the Claude Code MCP configuration file:
Add your server configuration to `~/.claude.json:
Replace /absolute/path/to/your/mcp-project-context
with the actual path to your project directory.
Verify the configuration:
Usage
Once configured, Claude Code will automatically start and connect to your MCP server. You can then use natural language to interact with your project context:
Example Commands
Create a new project:
Get current project status:
Add development tasks:
Record architectural decisions:
Update task status:
Add project notes:
Available Tools
The server provides these tools to Claude Code:
create_project
- Initialize a new project with tech stack and descriptionget_project_context
- Retrieve comprehensive project state and historylist_projects
- Show all projects ordered by last accessadd_task
- Create new development tasks with prioritiesupdate_task
- Modify task status, priority, or detailsadd_note
- Capture important observations and insightsrecord_decision
- Document architectural and technical decisionsstart_session
- Begin a development session with specific goals
Data Storage
Project data is stored in the data
directory:
Each file contains structured JSON data that you can inspect or backup as needed.
Development
Project Structure
Available Scripts
pnpm run build
- Compile TypeScript to JavaScriptpnpm run start
- Run the compiled serverpnpm run dev
- Run in development mode with auto-reload
Testing the Server
You can test the server manually:
For interactive testing, use the MCP Inspector:
Troubleshooting
Server Connection Issues
Verify the server builds successfully:
Check that the executable bit is set:
Test the server manually:
Verify Claude Code configuration:
Data Directory Issues
If you encounter permission errors, ensure the data directory exists and is writable:
Claude Code Logs
Check Claude Code logs for connection issues:
Privacy and Data
All project data is stored locally on your machine
No data is transmitted to external services
JSON files can be easily backed up or version controlled
Each developer/machine maintains separate project contexts
Contributing
Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request
License
MIT License - see LICENSE file for details
Support
For issues related to:
MCP Protocol: See Model Context Protocol documentation
Claude Code: See Claude Code documentation
READ THE DOCS: See official TS SDK for MCP
This Server: Open an issue in this repository
Tools
A persistent memory layer for Claude Code that maintains project information, technology stack, tasks, decisions, and session history between coding sessions, eliminating the need to re-explain project context.
Related MCP Servers
- AsecurityAlicenseAqualityAn improved implementation of persistent memory using a local knowledge graph with a customizable --memory-path. This lets Claude remember information about the user across chats.Last updated -9352660MIT License
- -securityAlicense-qualityA persistent memory implementation using a local knowledge graph that lets Claude remember information about users across conversations.Last updated -6MIT License
- AsecurityAlicenseAqualityAn implementation of persistent memory for Claude using a local knowledge graph, allowing the AI to remember information about users across conversations with customizable storage location.Last updated -1122854JavaScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that provides persistent memory and conversation continuity for Claude Desktop and Claude Code, allowing users to save and restore project context when threads hit token limits.Last updated -MIT License