项目上下文监控服务器

一个提供统一项目上下文和监控功能的MCP服务器,适用于开发项目的状态监控、构建诊断和Git集成。

  • by wblair8689
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 wblair8689/project-context-mcp

使用说明

项目上下文MCP服务器

一种模型上下文协议(MCP)服务器,为开发项目提供统一的项目上下文和监控功能。

特性

  • 项目状态监控:获取全面的项目健康和准备状态指标
  • 构建诊断:跟踪构建错误、警告和解决方案(启用Xcode监控时)
  • Git集成:监视存储库状态、分支和提交
  • 基础设施检查:验证项目结构和依赖关系
  • 会话上下文:使用完整的项目上下文初始化开发会话
  • 可配置的监控:为每个项目启用/禁用特定的监控功能

安装

  1. 克隆此存储库:

    git clone <repository-url>
    cd project-context-mcp
    
  2. 安装依赖项:

    pip install -r requirements.txt
    

用法

独立服务器

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

作为MCP服务器

添加到您的Claude配置中:

{
  "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"
    }
  }
}

配置

服务器创建 config/project_config.json 项目目录中的文件,设置如下:

  • project_name:项目的显示名称
  • current_phase:开发阶段描述
  • xcode_monitoring.enabled:启用/禁用Xcode特定功能
  • feature_groups:要监视的项目组件

可用工具

  • get_project_status():获取统一的项目状态和健康指标
  • get_diagnostics():获取包含解决方案的构建错误和警告
  • build():触发构建并获得即时反馈
  • fix_error(error_message, solution):应用修复和记录解决方案

许可证

MIT许可证