Project Context

Provides unified project context, health metrics, and build diagnostics for development projects.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You deploy the MCP Server to obtain unified project context and monitoring capabilities for development projects. It gives you project health metrics, build diagnostics, Git status, infrastructure checks, and an initialized conversation context to drive development sessions with full project context.

How to use

Use the MCP client to start a local or integrated session that queries project status, diagnostics, and build feedback. You can trigger a stand-alone server for quick testing or configure the MCP server to run as a persistent service within your Claude-enabled workflow. Practical patterns include starting a standalone server to validate project health, then wrapping it as an MCP server in your client configuration to enable automated health checks and quick fixes.

How to install

Prerequisites you need installed on your machine before starting:

Python 3.x installed on your system
Access to the internet to install Python dependencies

How to install

# 1) Clone the MCP server repository
git clone <repository-url>
cd project-context-mcp

# 2) Install dependencies
pip install -r requirements.txt

# 3) Run the standalone server (example usage)
python run_modular_server.py --project-root /path/to/your/project --transport stdio

How to install

To run the MCP server as part of your Claude configuration, use the provided MCP entry. This sets up the server to be invoked by the MCP client as a stdio process.

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

How to install

If you prefer the standalone invocation, you can start the server directly with the explicit project path.

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

Configuration

The server creates a config file in your project directory at config/project_config.json. This file holds display settings, monitoring options, and feature toggles.

Configuration

{
  "project_name": "Your Project",
  "current_phase": "Development",
  "xcode_monitoring": {
    "enabled": false
  },
  "feature_groups": {
    "enabled": true
  }
}

Additional notes

The MCP server exposes a set of tools you can invoke to get status, diagnostics, build, and error fixes. You can enable or disable monitoring features per project to tailor performance and noise levels.

Security and best practices

Run the MCP server in trusted environments and avoid exposing it publicly without proper authentication. Use the recommended project paths and ensure dependencies are kept up to date by running dependency installation regularly.

Troubleshooting

If the server fails to start, verify that Python 3.x is installed and that the path to the project root is correct. Check that dependencies listed in requirements.txt are installed without errors. Review the config/project_config.json for valid JSON and correct field names.

Notes

This MCP server provides unified project status, build diagnostics, Git integration, infrastructure checks, and session context to streamline development work. You can adjust monitoring features to balance insight with performance.

Available tools

get_project_status

Fetches unified project status and health metrics to assess overall readiness and health of the project.

get_diagnostics

Returns build errors and warnings with actionable solutions to help you diagnose and fix issues quickly.

build

Triggers a project build and returns immediate feedback on results and any failures.

fix_error

Applies a suggested fix for a given error message and records the corresponding solution for future reference.