wblair8689/project-context-mcp

Project Context MCP Server

A Model Context Protocol (MCP) server that provides unified project context and monitoring capabilities for development projects.

Features

• Project Status Monitoring: Get comprehensive project health and readiness metrics
• Build Diagnostics: Track build errors, warnings, and solutions (when Xcode monitoring enabled)
• Git Integration: Monitor repository status, branches, and commits
• Infrastructure Checking: Validate project structure and dependencies
• Conversation Context: Initialize development sessions with full project context
• Configurable Monitoring: Enable/disable specific monitoring features per project

Installation

1. Clone this repository:

   git clone <repository-url>
   cd project-context-mcp
   

2. Install dependencies:

   pip install -r requirements.txt
   

Usage

Standalone Server

python run_modular_server.py --project-root /path/to/your/project --transport stdio

As MCP Server

Add to your Claude configuration:

{
  "mcpServers": {
    "project-context": {
      "command": "python",
      "args": ["/path/to/project-context-mcp/run_modular_server.py", "--project-root", "/path/to/your/project"],
      "cwd": "/path/to/project-context-mcp"
    }
  }
}

Configuration

The server creates a config/project_config.json file in your project directory with settings:

• project_name: Display name for your project
• current_phase: Development phase description
• xcode_monitoring.enabled: Enable/disable Xcode-specific features
• feature_groups: Project components to monitor

Available Tools

• get_project_status(): Get unified project status and health metrics
• get_diagnostics(): Get build errors and warnings with solutions
• build(): Trigger build and get immediate feedback
• fix_error(error_message, solution): Apply fix and record solution

License

MIT License