mcptest

Automated testing for MCP servers. Like pytest, but for your tools.

Install

pip install mcptest-py

Quick start

# mcptest.yml
server:
  command: python my_server.py

tests:
  - name: "search works"
    tool: search_files
    input: { query: "hello" }
    assert:
      - status: success
      - result.length: "> 0"

$ mcptest run
✓ search works    search_files    45ms    2/2
1 passed · 45ms

Commands

mcptest run      # execute YAML test suite
mcptest audit    # auto-discover tools and check schema quality
mcptest check    # server health check (A–F grade)
mcptest init     # scaffold mcptest.yml from server's tool schemas

Full docs →