MCP Code Checker

MCP Code Checker

提供代码质量检查（pylint 和 pytest）的 MCP server，带有智能且适合LLM的提示语以进行分析和修复。使 Claude 和其他 AI 助手能够分析您的代码并提出改进建议。

GitHub
Created ByMarcusJellinghausMarcusJellinghaus

简介

MCP 代码检查器是一个模型上下文协议(MCP)服务器，使 Claude 等 AI 助手能够对您的代码执行质量检查。支持 pylint、pytest 分析并生成智能提示。

安装

# 克隆仓库
git clone https://github.com/yourusername/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

配置 Claude 桌面应用

  1. 打开 Claude 配置文件:

    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  2. 添加 MCP 服务器配置:

{
    "mcpServers": {
        "code_checker": {
            "command": "C:\\path\\to\\mcp_code_checker\\.venv\\Scripts\\python.exe",
            "args": [                
                "C:\\path\\to\\mcp_code_checker\\src\\main.py",
                "--project-dir",
                "C:\\path\\to\\your\\project"
            ],
            "env": {
                "PYTHONPATH": "C:\\path\\to\\mcp_code_checker\\"
            }
        }
    }
}
  1. 重启 Claude 桌面应用

可用工具

  • run_pylint_check: 执行 pylint 检查并生成智能提示
  • run_pytest_check: 执行 pytest 并生成智能提示
  • run_all_checks: 执行所有检查，生成合并结果

调试问题

  • 查看日志文件:

    • Windows: %APPDATA%\Claude\logs
    • 详见 MCP 文档

  • 使用 MCP Inspector:

    npx @modelcontextprotocol/inspector uv --directory C:\path\to\mcp_code_checker run src\main.py

安全特性

  • 所有操作受限于指定的项目目录
  • 代码执行仅限于项目内的 Python 测试文件

许可证

MIT 许可证