MCP FastAPI Server

A FastAPI-based async API server that communicates with Model Context Protocol (MCP) servers.

Features

- List available MCP servers
- List tools available from MCP servers
- Invoke tools on MCP servers

API Endpoints

- POST /api/list-mcp-servers: List all available MCP servers
- POST /api/list-tools: List all tools available from an MCP server
- POST /api/invoke-tool: Invoke a tool on an MCP server

Prerequisites

- Python 3.8 or higher
- An accessible MCP server (local or remote)

Installation

1. Clone this repository:

   git clone <repository-url>

   cd mcp-fastapi-server

   

2. Create a virtual environment:

   python -m venv venv

   source venv/bin/activate  # For Windows: venv\Scripts\activate

   

3. Install dependencies:

   pip install -r requirements.txt

   

4. Create a .env file from the example:

   cp .env.example .env

   

Running the Server

Start the server with:

uvicorn app.main:app --reload

This will start the server on http://localhost:8000.

API Usage Examples

List MCP Servers

curl -X POST http://localhost:8000/api/list-mcp-servers -H "Content-Type: application/json" -d '{}'

List Tools from an MCP Server

curl -X POST http://localhost:8000/api/list-tools -H "Content-Type: application/json" -d '{"server_url": "http://localhost:5000"}'

Invoke a Tool

curl -X POST http://localhost:8000/api/invoke-tool -H "Content-Type: application/json" -d '{
  "server_url": "http://localhost:5000",
  "tool_name": "example_tool",
  "params": {
    "parameter1": "value1",
    "parameter2": "value2"
  }
}'

Documentation

Once the server is running, you can access the interactive API documentation at:
- Swagger UI: http://localhost:8000/docs
- ReDoc: http://localhost:8000/redoc

License

MIT # chat-mcp