Metadata-Version: 2.4
Name: mcptest-py
Version: 0.1.0
Summary: Automated testing for MCP servers
Project-URL: Homepage, https://mcptest.org
Project-URL: Repository, https://github.com/YOUR/mcptest
Project-URL: Bug Tracker, https://github.com/YOUR/mcptest/issues
License-Expression: MIT
License-File: LICENSE
Keywords: agents,ai,mcp,model-context-protocol,testing
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.11
Requires-Dist: click>=8.1
Requires-Dist: jsonschema>=4.0
Requires-Dist: mcp>=1.0
Requires-Dist: pydantic>=2.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Description-Content-Type: text/markdown

# mcptest

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

[![PyPI](https://img.shields.io/pypi/v/mcptest-py)](https://pypi.org/project/mcptest-py/)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
[![CI](https://github.com/YOUR/mcptest/actions/workflows/ci.yml/badge.svg)]()

## Install

```bash
pip install mcptest-py
```

## Quick start

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

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

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

## Commands

```bash
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 →](https://mcptest.org)
