MCP Streamable HTTP Server

An MCP server using Streamable HTTP transport that runs with Docker Compose and connects to LM Studio.

Running with Docker Compose

docker compose up --build

Verify

• Health check: http://localhost:8000/health
• MCP endpoint: http://localhost:8000/mcp (Streamable HTTP)

LM Studio Configuration

Open LM Studio → Program tab → Install → Edit mcp.json and add:

{
  "mcpServers": {
    "my-local-mcp": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

After saving, your model will have access to the add, greet, and reverse_text tools.

Local Development (with uv)

uv sync
uv run uvicorn app.main:app --reload

Adding Tools

Add more @mcp.tool() decorated functions in app/main.py and rebuild:

docker compose up --build