MCP Code Checker

MCP Code Checker

site icon
2025.04.16 3
Python代码质量检查AI辅助开发自动化测试开发效率
MCP Code Checker 是一个基于 Model Context Protocol (MCP) 的服务器,提供代码质量检查功能。它通过 API 在指定项目目录中执行代码质量检查,遵循 MCP 协议设计。该服务器使 AI 助手(如 Claude)或其他兼容 MCP 的系统能够对代码进行质量检查,包括运行 pylint 和 pytest 检查,生成智能提示供大型语言模型(LLM)解释问题并提出修复建议。所有操作都在用户指定的项目目录中安全执行,确保用户控制的同时实现强大的 AI 协作代码质量改进。
View on GitHub

Overview

基本能力

产品定位

MCP Code Checker 是一个代码质量检查工具,旨在通过 AI 协作提升代码质量和开发效率。

核心功能

  • run_pylint_check: 在项目代码上运行 pylint,并生成供 LLM 解释的智能提示
  • run_pytest_check: 在项目代码上运行 pytest,并生成供 LLM 解释的智能提示
  • run_all_checks: 运行所有代码检查(pylint 和 pytest)并生成综合结果

适用场景

  • AI 辅助代码质量检查
  • 自动化代码审查
  • 开发过程中的持续质量监控
  • 教育与培训中的代码质量评估

工具列表

  1. Run Pylint Check: 运行 pylint 检查代码质量,识别风格问题和潜在错误
  2. Run Pytest Check: 运行 pytest 识别失败的测试
  3. Run All Checks: 综合运行 pylint 和 pytest 检查,提供全面的代码质量分析

常见问题解答

  • 所有检查操作都限制在指定的项目目录中执行,确保安全性
  • 结果格式既适合人类阅读也适合 LLM 解释
  • 可通过参数自定义检查行为(如禁用特定 pylint 错误码、指定测试文件夹等)

使用教程

使用依赖

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

# 创建并激活虚拟环境(推荐)
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# 安装依赖
pip install -e .

安装教程

# 运行服务器
python -m src.main --project-dir /path/to/project [--python-executable /path/to/python] [--venv-path /path/to/venv]

调试方式

  1. 使用 MCP Inspector 调试:
npx @modelcontextprotocol/inspector uv --directory C:\path\to\mcp_code_checker run src\main.py
  1. 在 MCP Inspector web UI 中配置:
  2. Python 解释器路径
  3. 参数(包括项目目录路径)
  4. 环境变量(PYTHONPATH)
  5. 这将启动服务器并提供调试界面测试可用工具

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。