forge-mcp

# 🔨 mcp-forge **pytest for MCP servers — test any server, no LLM required.** [](https://pypi.org/project/forge-mcp/) [](https://pypi.org/project/forge-mcp/) [](https://github.com/ioteverythin/forgemcp/actions/workflows/ci.yml) [](https://opensource.org/licenses/MIT) mcp-forge is a testing framework for [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) servers. It works with **any** MCP server — Python, TypeScript, Go, Rust — and requires **zero LLM calls**. Tests are deterministic, fast, and free to run in CI/CD. ## Why? Most MCP server testing today looks like this: spin up Claude Desktop, type a prompt, squint at the output, and hope it called the right tool. That's vibe-testing. mcp-forge gives you real tests: ```python import pytest from mcp_forge import MCPTestClient @pytest.fixture async def client(): async with MCPTestClient.from_command("python my_server.py") as c: yield c async def test_tool_exists(client): tools = await client.list_tools() assert "search_files" in [t.name for t in tools] async def test_search_works(client): result = await client.call_tool("search_files", {"query": "README"}) assert result.is_success assert "README.md" in result.text async def test_search_snapshot(client, forge_snapshot): result = await client.call_tool("search_files", {"query": "README"}) forge_snapshot.assert_match(result) ``` ## Installation ```bash pip install forge-mcp ``` With FastMCP in-memory testing support: ```bash pip install "forge-mcp[fastmcp]" ``` ## Quick Start ### 1. Write tests directly ```python from mcp_forge import MCPTestClient async def test_my_server(): async with MCPTestClient.from_command("python my_server.py") as clien…