# 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:
```bash
git clone <repository-url>
cd project-context-mcp
```
2. Install dependencies:
```bash
pip install -r requirements.txt
```
## Usage
### Standalone Server
```bash
python run_modular_server.py --project-root /path/to/your/project --transport stdio
```
### As MCP Server
Add to your Claude configuration:
```json
{
"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
