项目简介

CodingManagerMCP 是一个 AI 驱动的项目管理 Agent，旨在通过 Model Context Protocol (MCP) 与 Cursor IDE 等客户端集成。它的核心功能是维护关于特定软件项目的深入上下文，包括架构、编码标准、需求和目标，并利用这些知识增强开发者的工作流程。

主要功能点

代码验证 ('validate_code'): 根据项目上下文、标准和目标，对代码片段或文件进行验证，提供反馈和建议。
获取项目建议 ('get_project_advice'): 回答开发者关于项目的疑问，提供上下文相关的建议和参考资料。
更新 Agent 上下文 ('update_manager_context'): 允许开发者明确地更新 Agent 对项目知识的理解，例如增加新的依赖、架构决策或需求。
获取任务启动上下文 ('get_task_starting_context'): 在开始新的编码任务前，提供相关的项目背景、关键模块、设计模式和注意事项。
流式主动建议 ('stream_proactive_suggestions'): 主动向客户端推送上下文相关的提示、潜在问题警告和最佳实践建议。

安装步骤

克隆仓库:

git clone https://github.com/Kamilbenkirane/CodingManagerMCP.git
cd CodingManagerMCP

创建虚拟环境并安装依赖: 使用 'uv' 工具（需提前安装 Python 3.9+ 和 uv）

uv venv
source .venv/bin/activate  # 在 Windows 上使用: .venv\Scripts\activate
uv pip install -e '.[dev]'

安装 pre-commit 钩子 (可选但推荐):

uv run pre-commit install

运行服务器: 详细的运行脚本将在 'scripts/run_server.sh' 中提供。当前阶段（开发中）可以参考使用 'uvicorn' 直接启动：
```
uv run uvicorn src.manager_agent.mcp_server:app --reload
```
请确保您已经激活了之前创建的虚拟环境。

服务器配置

本项目作为 MCP 服务器，需要被 MCP 客户端（例如 Cursor IDE）调用和管理。您需要在 MCP 客户端的配置中添加此服务器。配置信息通常以 JSON 格式提供，包含服务器的名称 (name)、用于启动服务器进程的命令 (command) 以及传递给该命令的参数列表 (args)。

根据本项目的结构，一个典型的客户端配置示例所需要的命令和参数如下：

'name': 为此 MCP 服务器起一个易于识别的名称，例如 "Coding Manager MCP"。
'command': 启动服务器进程的命令。如果您的系统中已经正确安装并配置了 'uv' 并且项目依赖已安装，可以直接使用 'uv'。如果需要指定虚拟环境中的 'uv'，您可能需要提供完整的路径（例如 '/path/to/your/.venv/bin/uv'）。
'args': 传递给 'command' 的参数列表。对于使用 uvicorn 启动的情况，通常是 '["run", "uvicorn", "src.manager_agent.mcp_server:app"]'。如果您在开发中需要热重载，可以加上 '"--reload"' 参数，例如 '["run", "uvicorn", "src.manager_agent.mcp_server:app", "--reload"]'。

请根据您的实际安装路径和环境配置这些信息到您的 MCP 客户端中。

基本使用方法

MCP 服务器一旦运行，它将监听客户端的连接请求。您主要通过支持 MCP 协议的客户端（如 Cursor IDE）与 Agent 进行交互。在 IDE 中执行代码验证、寻求项目帮助、或开始新的编码任务时，IDE 会自动通过配置好的 MCP 连接与 CodingManagerMCP 服务器通信，由服务器处理请求并返回结果显示在 IDE 界面中。例如，在 Cursor IDE 中使用相关的 Agent 功能时，Agent 将提供基于项目上下文的代码反馈或建议。

关键词

信息