MCP-Anything

mcp-anything demo

Turn any codebase into an MCP server. One command.

mcp-anything generate /path/to/app

Point it at any project — Python, Go, Java, Rust, Ruby, TypeScript — and get a production-ready MCP server package. No manual wrapping. No boilerplate.

Beyond tool calls — built for the agentic era

MCP is evolving fast. mcp-anything generates servers that use the full protocol, not just tools:

Feature	What it does
Streamable HTTP	Deploy MCP servers remotely over HTTP/SSE, not just local stdio
MCP Prompts	Server-delivered skills that teach agents how to use your tools
MCP Resources	Dynamic, always-up-to-date documentation — not stale markdown files
AGENTS.md	Structured tool index that Cursor, Claude Code, and Copilot discover automatically
OpenTelemetry	Trace every tool invocation — monitor what your agents are actually doing
Docker	One command to containerize and deploy anywhere

Quick Start

git clone https://github.com/gabrielekarra/mcp-anything.git
cd mcp-anything
pip install -e ".[dev,llm]"

# Generate a server
mcp-anything generate /path/to/your/app

What Gets Generated

mcp-<name>-server/
├── src/<name>/
│   ├── server.py        # FastMCP server (stdio or HTTP)
│   ├── backend.py       # Backend adapter (CLI/HTTP/API)
│   ├── tools/           # Tool modules by category
│   ├── prompts.py       # Server-delivered MCP prompts
│   └── resources.py     # Dynamic MCP resources
├── tests/               # Generated pytest tests
├── AGENTS.md            # Tool index for coding agents
├── Dockerfile           # Container deployment (HTTP mode)
└── pyproject.toml       # pip install -e .

Local or Remote

Local (stdio) — the default. Runs as a subprocess, zero config:

mcp-anything generate /path/to/app

Remote (HTTP) — streamable HTTP/SSE transport for production deployment:

mcp-anything generate /path/to/app --transport http

This adds OpenTelemetry tracing, a Dockerfile, and an HTTP endpoint your agents can reach over the network.

Supported Languages & Frameworks

Language	Frameworks
Python	FastAPI, Flask, Django REST, Click, Typer, argparse
Java	Spring Boot
TypeScript/JS	Express.js
Go	Gin, Echo, Chi, net/http, gorilla/mux
Ruby	Rails
Rust	Actix, Axum, Rocket, Warp
Any	OpenAPI/Swagger specs, GraphQL SDL, gRPC/Protobuf

Plus WebSocket detection (FastAPI-WS, Django Channels, Socket.IO), cross-file import resolution, and schema extraction from Pydantic models, Java POJOs, and TypeScript interfaces.

Commands

mcp-anything generate /path/to/app     # Full pipeline: analyze → package
mcp-anything analyze /path/to/app      # Analysis only
mcp-anything serve ./mcp-myapp-server  # Run without installing
mcp-anything status ./mcp-myapp-server # Check generation status

Key Flags

--transport http     Streamable HTTP instead of stdio
--name NAME          Override server name
--no-llm             Static analysis only (no API key needed)
--no-install         Skip dependency installation
--resume             Resume from saved pipeline state

Example

mcp-anything generate /path/to/httpstat --name httpstat

Add to your Claude Code config:

{
  "mcpServers": {
    "httpstat": {
      "command": "mcp-httpstat"
    }
  }
}

Or with HTTP transport:

{
  "mcpServers": {
    "httpstat": {
      "url": "http://localhost:8000/sse"
    }
  }
}

How It Works

ANALYZE → DESIGN → IMPLEMENT → TEST → DOCUMENT → PACKAGE

15 static detectors scan your codebase for IPC patterns (CLI args, HTTP routes, gRPC services, GraphQL schemas, WebSocket endpoints). Optional LLM analysis via Claude API enhances tool descriptions and grouping. Jinja2 templates emit valid, tested Python. Pipeline state is saved as JSON for resume support.

Development

pip install -e ".[dev,llm]"
pytest tests/ -v

See CONTRIBUTING.md for the architecture guide and how to add new detectors.

See ROADMAP.md for what's shipped and what's next.

License

MIT

mcp-anything