FastMCP Server

MCP server project

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "joseph19820124-joseph_mcp_server": {
      "command": "uv",
      "args": [
        "run",
        "--python",
        "/Users/you/your_project/.venv/bin/python",
        "fastmcp",
        "run",
        "/Users/you/your_project/main.py"
      ]
    }
  }
}

You can run a FastMCP-based server locally and connect it to an MCP client to exchange automated actions and data. This setup uses Ultraviolet (uv) for environment handling and Python to execute the MCP logic, making it easy to develop, test, and iterate on MCP-based workflows.

How to use

You launch the MCP server locally and connect an MCP client to it. Once running, the client can request actions, fetch data, or coordinate tasks with the server. Use the client’s standard MCP connection flow to pair with this server, and rely on the server’s Python runtime to execute the requested logic.

How to install

Prerequisites you need before installing:

uv
Python 3.12 Install and prepare the environment:
Create a virtual environment using the uv workflow
Synchronize dependencies with uv
Ensure your paths point to the correct project directory and virtual environment

uv venv
uv sync

Additional content

Configure and run the MCP server in your environment. The following examples show two ways you can integrate this MCP server with your IDE or tooling.

// Example: Run the MCP server directly on macOS (adjust paths to your project root)
uv run --python /Users/you/your_project/.venv/bin/python fastmcp run /Users/you/your_project/main.py

Adding this MCP on IDEs

To connect with Claude Desktop or Claude Code, use the prepared MCP configuration blocks below. These let Claude manage and launch the MCP server from your IDE.

{
  "mcpServers": {
    "fastmcp": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--python",
        "/Users/you/your_project/.venv/bin/python",
        "fastmcp",
        "run",
        "/Users/you/your_project/main.py"
      ]
    }
  }
}

claude mcp add uv run --python /Users/you/your_project/.venv/bin/python fastmcp run /Users/you/your_project/main.py