Skip to main content
Glama

Mutmut MCP

一个用于通过 mutmut 管理突变测试的 Model Context Protocol (MCP) 服务器。该工具提供了一组程序化 API,用于运行突变测试、分析结果以及改进 Python 项目的测试覆盖率。

功能

  • 在任何 Python 模块或包上运行突变测试会话

  • 显示整体突变测试结果和存活突变

  • 建议需要更好测试覆盖率的区域

  • 对特定存活突变或所有存活突变重新运行 mutmut

  • 清理 mutmut 缓存

  • 专为自动化以及与其他 MCP 工具集成而设计

Related MCP server: MCP Python Server

安装

# Run directly from GitHub (no install needed)
uvx --from git+https://github.com/wdm0006/mutmut-mcp mutmut-mcp

# Or install from source
git clone https://github.com/wdm0006/mutmut-mcp
cd mutmut-mcp
uv sync
uv run mutmut_mcp.py

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 mutmut-mcp:

npx -y @smithery/cli install @wdm0006/mutmut-mcp --client claude

MCP 客户端配置

{
  "mcpServers": {
    "mutmut": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/wdm0006/mutmut-mcp", "mutmut-mcp"]
    }
  }
}

API / 工具

以下工具可用:

  • run_mutmut(target, options="", venv_path=None, project_path=None) – 在目标上运行突变测试会话

  • show_results(venv_path=None, project_path=None) – 显示整体结果

  • show_survivors(venv_path=None, project_path=None) – 列出存活突变,并带有一个标明“无测试覆盖”的突变体小节

  • rerun_mutmut_on_survivor(mutation_id=None, venv_path=None, project_path=None) – 对特定存活突变或所有存活突变重新运行 mutmut

  • clean_mutmut_cache(venv_path=None, project_path=None) – 清理 mutmut 缓存

  • show_mutant(mutation_id, venv_path=None, project_path=None) – 显示特定突变体的代码差异和详细信息

  • prioritize_survivors(venv_path=None, project_path=None) – 按可能的重要性对未覆盖突变体和存活突变进行排序

project_path

每个工具都接受一个可选的 project_path:该目录包含项目的 mutmut 配置(setup.cfg / pyproject.toml 中的 [mutmut] source_paths=)、项目源码、 测试,以及 mutmut 的 mutants/ 状态目录。mutmut 会将该目录作为其工作目录, 而 clean_mutmut_cache 只会删除该目录内部的状态。

只要服务器不是从项目目录启动的,就应传入该参数——这通常适用于 桌面 MCP 客户端和 uvx。如果省略,工具会回退到服务器进程的工作 目录,因此现有的调用行为保持不变。如果 project_path 不是现有目录, 则返回错误,且不会运行 mutmut 或删除任何内容。

venv_path

venv_path 指向保存项目 mutmut 的虚拟环境(工具使用 <venv>/bin/mutmut,在 Windows 上为 <venv>\Scripts\mutmut.exe);如果省略,则从 PATH 获取 mutmut。当同时提供 venv_path 和 project_path 时,相对 venv_path 会相对于 project_path 进行解析,因此常见的 .venv 写法也可用:

{ "project_path": "/home/me/src/myproject", "venv_path": ".venv" }

许可证

本项目采用 MIT 许可证授权。详见 LICENSE。

Available Tools

7 tools
clean_mutmut_cacheB

Clean mutmut cache using the mutmut CLI (if available), otherwise remove .mutmut-cache file. Returns the plain text output or confirmation message.

Inputs: venv_path. Returns: result

prioritize_survivorsA

Prioritize surviving mutants by likely materiality, filtering out log/debug-only changes and ranking by potential impact. Returns a sorted list of survivors with reasons for prioritization.

Inputs: venv_path. Returns: object

rerun_mutmut_on_survivorB

Rerun mutmut on specific surviving mutations or all survivors after test updates using the mutmut CLI. Returns the plain text output.

Inputs: mutation_id, venv_path. Returns: result

run_mutmutA

Run a full mutation testing session with mutmut on the specified target.

This tool initiates mutation testing on the given module or package. You can provide additional mutmut options as needed. The output includes a summary of mutations tested, including counts of killed, survived, and timed-out mutations. If a virtual environment path is provided, mutmut will be run using the binaries from that environment to ensure compatibility with project-specific dependencies.

Args: target (str): The module or package to run mutation testing on. options (str): Additional command-line options for mutmut (e.g., '--use-coverage'). Defaults to empty. venv_path (Optional[str]): Path to the project's virtual environment to use for running mutmut. Defaults to None.

Returns: str: Summary of the mutation testing run, or error message if the run fails.

Inputs: target (required), options, venv_path. Returns: result

show_mutantB

Show the code diff and details for a specific mutant using mutmut show. Args: mutation_id (str): The ID of the mutant to show. venv_path (Optional[str]): Path to the virtual environment, if any. Returns: str: The output of 'mutmut show <mutation_id>'.

Inputs: mutation_id (required), venv_path. Returns: result

show_resultsC

Display overall results from the last mutmut run using the mutmut CLI. Returns the plain text output.

Inputs: venv_path. Returns: result

show_survivorsC

List details of surviving mutations from the last mutmut run using the mutmut CLI. Returns the plain text output.

Inputs: venv_path. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a distinct purpose: run_mutmut initiates testing, show_results displays overall results, show_survivors lists survivors, show_mutant shows specific mutant details, rerun_mutmut_on_survivor retests survivors, prioritize_survivors ranks survivors, and clean_mutmut_cache manages cache. There is no overlap or ambiguity in functionality.

    Naming Consistency5/5

    All tools follow a consistent snake_case naming pattern with clear verb_noun structures (e.g., run_mutmut, show_results, clean_mutmut_cache). The naming is predictable and readable throughout the set.

    Tool Count5/5

    With 7 tools, this server is well-scoped for mutation testing with mutmut. Each tool serves a specific role in the workflow, from running tests to analyzing results, without being overly sparse or bloated.

    Completeness5/5

    The tool set provides complete coverage for the mutmut domain: it includes core testing (run_mutmut), result inspection (show_results, show_survivors, show_mutant), survivor management (rerun_mutmut_on_survivor, prioritize_survivors), and maintenance (clean_mutmut_cache). There are no obvious gaps in the mutation testing lifecycle.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      A Model Context Protocol server that enables AI assistants like Claude to perform Python development tasks through file operations, code analysis, project management, and safe code execution.
      9
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Python-based implementation of the Model Context Protocol that enables communication between a model context management server and client through a request-response architecture.
      -
    • F
      license
      A
      quality
      Not graded
      maintenance
      A Model Context Protocol server that allows LLMs to interact with Python environments, enabling code execution, file operations, package management, and development workflows.
      9
      -