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