Skip to main content
Glama
shadrach-tayo

mcp-starter

by shadrach-tayo
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

mcp-starter

Local FastMCP servers managed with uv (Python 3.13+).

Setup

uv sync
source .venv/bin/activate  # optional; uv run works without it

Related MCP server: Todo MCP Server

Servers

Server

Entrypoint

HTTP port

Todo MCP

mcp-starter

8005

Postgres MCP

postgres-mcp

8006

Run (no reload)

uv run mcp-starter
uv run postgres-mcp

Run with hot reload (recommended for development)

Prefer FastMCP’s built-in reload (cleaner process teardown than wrapping with watchfiles):

# Todo MCP
uv run fastmcp run src/mcp_starter/__init__.py:mcp \
  --transport http --host 127.0.0.1 --port 8005 \
  --reload --reload-dir src

# Postgres MCP
uv run fastmcp run src/postgres_mcp/__init__.py:mcp \
  --transport http --host 127.0.0.1 --port 8006 \
  --reload --reload-dir src

Alternative using watchfiles:

uv run watchfiles --filter python 'uv run postgres-mcp' src

If reload fails with address already in use, an old process is still bound to the port:

lsof -nP -iTCP:8006 -sTCP:LISTEN
kill <pid>

Clients

uv run mcp-client        # hits http://localhost:8005/mcp
uv run postgres-client   # hits http://localhost:8006/mcp

Start the matching server first.

Claude Desktop (stdio)

Claude Desktop uses stdio, not HTTP. Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

"todo-mcp": {
  "command": "uv",
  "args": [
    "--directory",
    "/Users/tayo/code/courses/AI/Claude/mcp-starter",
    "run",
    "fastmcp",
    "run",
    "src/mcp_starter/__init__.py:mcp"
  ]
},
"postgres-mcp": {
  "command": "uv",
  "args": [
    "--directory",
    "/Users/tayo/code/courses/AI/Claude/mcp-starter",
    "run",
    "fastmcp",
    "run",
    "src/postgres_mcp/__init__.py:mcp"
  ]
}

Fully quit and reopen Claude Desktop after editing.

Package commands

uv add <package>
uv remove <package>
uv sync

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Simple Remote MCP Server

    ParthSharma1197
    F
    license
    B
    quality
    D
    maintenance
    A template and demonstration project for building, testing, and deploying remote MCP servers using FastMCP and uv. It provides a foundational structure for creating MCP-compliant tools that can be hosted publicly and integrated with LLM agents.
    2
    -

  • Todo MCP Server

    bxxf
    F
    license
    Not graded
    quality
    D
    maintenance
    A multi-node todo application server using MCP protocol, Redis for storage, and OpenRouter for AI-powered prioritization analysis.
    -

  • fastapi-mcp-todo

    egafossojm
    F
    license
    Not graded
    quality
    C
    maintenance
    FastAPI Todo API with an MCP server for managing todos, deployable to Render, AWS App Runner, or ECS.
    -