rest-to-mcp-adapter

# REST-to-MCP Adapter **A Python library for converting REST API specifications into MCP (Model Context Protocol) tools for AI agents.** Transform any REST API specification into tools that Claude, GPT, and other LLM-powered agents can use. **Supported Formats:** - OpenAPI 3.x (JSON, YAML) - Swagger 2.x (JSON, YAML) - OpenAPI Actions format (JSON) [](https://www.python.org/downloads/) [](https://opensource.org/licenses/MIT) [](https://pypi.org/project/rest-to-mcp-adapter/) > **⚠️ Beta Status**: This library is currently in beta (v0.1.0). The core functionality is stable and production-ready, but the API may evolve based on community feedback. We welcome early adopters and contributors! --- ## 🚀 Quick Start ```python from adapter import ( OpenAPILoader, Normalizer, ToolGenerator, ToolRegistry, APIExecutor, BearerAuth, MCPServer ) # 1. Load OpenAPI spec loader = OpenAPILoader() spec = loader.load("https://api.example.com/openapi.json") # 2. Normalize to canonical format normalizer = Normalizer() endpoints = normalizer.normalize_openapi(spec) # 3. Generate MCP tools (auth params auto-filtered!) generator = ToolGenerator(api_name="myapi") tools = generator.generate_tools(endpoints) # 4. Create tool registry registry = ToolRegistry(name="My API") registry.add_tools(tools) # 5. Set up API executor with authentication executor = APIExecutor( base_url="https://api.example.com", auth=BearerAuth(token="your-token") ) # 6. Start MCP server (for Claude Desktop, etc.) server = MCPServer( name="My API Server", version="1.0.0", tool_registry=registry, executor=executor, endpoints=endpoints ) server.run() # Claude can now use your API! ``` --- ## 📦 Installation ### From PyPI (Recommended) ```bash pip install …