🚀 MCP 代码检查服务器文档

MCP 代码检查服务器是一款基于模型上下文协议 (MCP) 的实用工具，可在项目里执行代码检查操作。它支持运行 pylint 和 pytest 检查，还能通过 MCP 协议与 Claude Desktop 等外部系统进行交互，为代码质量把控提供有力支持。

🚀 快速开始

MCP 代码检查服务器借助 MCP 协议，可在项目中执行代码检查，支持 pylint 和 pytest 检查，并能与外部系统交互。

✨ 主要特性

• 多工具支持：支持运行 pylint 和 pytest 检查，可对代码进行全面检测。
• 交互性强：通过 MCP 协议与外部系统（如 Claude Desktop）交互，方便信息传递。
• 安全可靠：所有检查在指定项目目录内执行，代码执行限制在项目的 Python 测试文件中，且结果格式适合人类和 LLM 解读。

📦 安装指南

在 Windows 上设置开发环境

REM 克隆仓库
git clone https://github.com/yourusername/mcp-code-checker.git
cd mcp-code-checker

REM 创建并激活虚拟环境
python -m venv .venv
.venv\Scripts\activate

REM 安装依赖项
pip install -e .

REM 安装开发依赖项
pip install -e ".[dev]"

💻 使用示例

执行 pylint 检查

• 功能：在项目中运行 pylint 并生成适合 LLM 解释的结果。
• 返回：包含 pylint 结果或提示 LLM 的字符串。
• 帮助：识别代码质量、样式问题和潜在错误。
• 配置：支持禁用特定 pylint 代码。

执行 pytest 检查

• 功能：在项目中运行 pytest 并生成适合 LLM 解释的结果。
• 返回：包含 pytest 结果或提示 LLM 的字符串。
• 帮助：识别失败的测试并提供详细的测试失败信息。
• 配置：支持测试选择、环境和详细程度参数。

执行所有检查

• 功能：在项目中运行 pylint 和 pytest 检查，生成综合结果。
• 返回：包含所有检查结果或提示 LLM 的字符串。
• 帮助：提供代码质量的全面分析。
• 配置：支持 pylint 和 pytest 参数。

🔧 技术细节

• 执行范围：所有检查均在指定项目目录内执行，代码执行限制在项目的 Python 测试文件中。
• 结果格式：结果格式适合人类和 LLM 解读，方便不同用户使用。

📚 详细文档

开发指南

使用 MCP Dev Tools 运行

# 设置 PYTHONPATH 并运行服务器模块
set PYTHONPATH=. && mcp dev src/server.py

📄 许可证

该项目在 MIT 许可证下发布，详细信息请查看 LICENSE 文件。MIT 许可证是一种宽松的许可协议，允许重新使用、复制、修改和分发，只要适当归功即可。

🔗 链接

• MCP Python SDK
• MCP 文件系统工具