MCPilot

A powerful, FastAPI-based gateway for the Model Context Protocol (MCP), designed to unify and scale your AI toolchain.

MCPilot is nowfully functionalwith the following working features:

- FastAPI Gateway Server- Running onhttp://localhost:8000/docs
- Admin Dashboard- Beautiful web UI athttp://localhost:8000
- REST API Endpoints- Full CRUD operations via /api/v1/
- API Wrapper System- Convert REST APIs to MCP tools (tested with JSONPlaceholder)
- Configuration Management- Environment-based settings
- Transport Framework- Ready for HTTP, WebSocket, SSE, stdio
- Modular Architecture- Clean separation of concerns
- Interactive Documentation- OpenAPI/Swagger UI at /docs

# Example: JSONPlaceholder API → MCP Tool result = await gateway.call_tool( "api:jsonplaceholder:get_user", {"user_id": "1"} ) # Returns: Full user data from REST API

src/mcpilot/ ├── main.py # FastAPI application entry point ├── config.py # Configuration management ├── gateway.py # Core MCP federation logic ├── api.py # REST API endpoints ├── admin.py # Admin management endpoints ├── transports.py # Transport layer implementations ├── api_wrapper.py # REST API to MCP tool wrapper ├── middleware.py # Request/response middleware └── server.py # Original MCP server implementation

# Using uv (recommended) uv sync # Or using pip pip install -e .

# Run the FastAPI server uv run python -m mcpilot.main # Or using uvicorn directly uvicorn mcpilot.main:app --reload --host 0.0.0.0 --port 8000

# Server Configuration MCPILOT_HOST=0.0.0.0 MCPILOT_PORT=8000 MCPILOT_DEBUG=false # CORS Settings MCPILOT_CORS_ORIGINS=[""] # Logging MCPILOT_LOG_LEVEL=INFO

Configure MCP servers via the admin API or by setting up the configuration:

from mcpilot.config import MCPServerConfig server_config = MCPServerConfig( name="my-server", type="stdio", command="python", args=["-m", "my_mcp_server"], enabled=True )

from mcpilot.config import APIWrapperConfig api_config = APIWrapperConfig( name="my-api", base_url="https://api.example.com", auth_type="bearer", auth_config={"token": "your-token"}, endpoints=[ { "name": "get_user", "method": "GET", "path": "/users/{user_id}", "description": "Get user information", "path_params": [ {"name": "user_id", "type": "string", "required": True} ] } ] )

- GET /api/v1/tools- List all available tools
- POST /api/v1/tools/call- Call a tool
- GET /api/v1/prompts- List all available prompts
- POST /api/v1/prompts/get- Get a prompt
- GET /api/v1/resources- List all available resources
- POST /api/v1/resources/read- Read a resource

- GET /admin/servers- List MCP servers
- POST /admin/servers- Add new MCP server
- PUT /admin/servers/{name}- Update MCP server
- DELETE /admin/servers/{name}- Remove MCP server
- GET /admin/api-wrappers- List API wrappers
- POST /admin/api-wrappers- Add new API wrapper

- GET /health- Health check endpoint
- GET /api/v1/status- Gateway and server status
- GET /admin/metrics- System metrics

Connect to the WebSocket endpoint for real-time MCP communication:

const ws = new WebSocket('ws://localhost:8000/api/v1/ws'); // Send MCP JSON-RPC message ws.send(JSON.stringify({ "jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {} }));

# Install development dependencies uv sync --dev # Run with auto-reload uvicorn mcpilot.main:app --reload --host 0.0.0.0 --port 8000

# Run tests (when implemented) uv run pytest # Type checking uv run mypy src/mcpilot

This project is licensed under the MIT License.

Contributions are welcome! Please feel free to submit a Pull Request.

MCPilot also includes the original MCP server functionality for development and testing:

The server implements a simple note storage system with:

- Custom note:// URI scheme for accessing individual notes
- Each note resource has a name, description and text/plain mimetype

- summarize-notes: Creates summaries of all stored notes

- Optional "style" argument to control detail level (brief/detailed)
- Generates prompt combining all current notes with style preference

- add-note: Adds a new note to the server

- Takes "name" and "content" as required string arguments
- Updates server state and notifies clients of resource changes

[TODO: Add configuration details specific to your implementation]

On MacOS:~/Library/Application\ Support/Claude/claude_desktop_config.jsonOn Windows:%APPDATA%/Claude/claude_desktop_config.json

To prepare the package for distribution:

This will create source and wheel distributions in thedist/directory.

Note: You'll need to set PyPI credentials via environment variables or command flags:

- Token:--tokenorUV_PUBLISH_TOKEN
- Or username/password:--username/UV_PUBLISH_USERNAMEand--password/UV_PUBLISH_PASSWORD

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using theMCP Inspector.

You can launch the MCP Inspector vianpmwith this command:

npx @modelcontextprotocol/inspector uv --directory C:\Users\ary7s\OneDrive\Desktop\MCPilot run mcpilot

Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB