mcp_test_framework

washyu/mcp_test_framework

★ 0 stars Python AI/LLM Updated today

A pytest-based framework for testing MCP (Model Context Protocol) servers. v1.0 ships an end-to-end test harness for one MCP tool (schema -> call -> Ollama-judged description quality -> output conformance) with a Typer CLI.

View on GitHub → 🔍 Audit Wallet Slippage →

Quick Install

Copy the config for your editor. Some servers may need additional setup — check the README.

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "mcp_test_framework": {
      "command": "uvx",
      "args": [
        "mcp-test-framework"
      ]
    }
  }
}

Or install with pip: pip install mcp-test-framework

README Excerpt

Pytest-native MCP contract testing — for any MCP server, configured via one ini line. ```bash uv add mcp-contracts uv sync ``` ```toml mcp_config_file = "./config.yaml" ``` ```bash uv run pytest ``` Library mode is the recommended way to run `mcp-contracts`. Declare one line in your `pyproject.toml`, write a minimal `config.yaml`, and every `pytest`

Tools (13)

JUDGE_TIMEOUT_SECONDSMCP_SERVER_ARGSMCP_SERVER_COMMANDMCP_SERVER_TIMEOUT_SECONDSOLLAMA_BASE_URLOLLAMA_MODELOLLAMA_TIMEOUT_SECONDScall_argumentsdepends_onjudgessetupskipskip_reason

mcp_test_framework

Quick Install

README Excerpt

Tools (13)

Related AI/LLM Servers