MCP API

This server exposes an MCP interface over a FastAPI application, letting you interact with generated MCP tools for CRUD-style operations through a standard HTTP endpoint and a local UI. It provides a structured way to manage tools and their endpoints via the MCP client ecosystem.

How to use

You access the MCP interface once the server is running by visiting the MCP URL at /mcp on your local host. From there, you can interact with the generated tools (endpoints decorated for MCP) using an MCP client or directly through the UI. This setup enables you to perform create, read, update, and delete actions on resources exposed by your FastAPI endpoints through the MCP workflow.

How to install

Prerequisites you need installed on your machine are Python and a working internet connection to install dependencies. You will create a virtual environment, activate it, install dependencies, and then run the server.

python -m venv venv

Activate the virtual environment appropriate for your operating system.

# Windows
.\venv\Scripts\activate

# macOS/Linux
source venv/bin/activate

Install the required dependencies from the project’s requirements file.

pip install -r requirements.txt

Run the server using one of the two common approaches. You can start with the autoreload capability during development or run the application directly.

uvicorn main:app --reload

python main.py

Once the server starts, you can open the interactive API docs at /docs (Swagger UI) and /redoc (ReDoc) in your browser.

Additional notes

Using MCP with this server, you can also interact with the generated MCP tools through a local MCP client. The path /mcp hosts the MCP interface where you will find your endpoints decorated for MCP interaction.

If you want to integrate this server with a cursor-style workflow, you can add an MCP JSON configuration to your cursor with the following entry to enable MCP access to the local server interface.

"mcp-crud": {
  "url": "http://127.0.0.1:8000/mcp"
}