cafe-mcp-server

A minimal Python MCP server that recommends coffee from local static data.

This demo does not call external APIs and does not require an API key.

Tools

• list_coffee_menu: returns the full static menu.
• recommend_coffee: recommends one drink from mood, milk, caffeine, and temperature preferences.
• explain_recommendation: explains a selected drink against the same preference inputs.

Install

cd /Users/hanlufeng/Desktop/AI-INSIGHT-REPORT/Ceilia/cafe-mcp-server
python -m venv .venv
source .venv/bin/activate
python -m pip install -e ".[dev]"

Run

Local stdio MCP server:

cafe-mcp-server

Equivalent module form:

python -m cafe_mcp_server.server

Cloud Run / HTTP mode:

PORT=8080 python -m cafe_mcp_server.server

When PORT is set, the server automatically uses Streamable HTTP, binds to 0.0.0.0:$PORT, and exposes MCP at:

/mcp

You can also force the transport explicitly:

MCP_TRANSPORT=streamable-http PORT=8080 python -m cafe_mcp_server.server
MCP_TRANSPORT=stdio python -m cafe_mcp_server.server

For Cloud Run repository deployment with Buildpacks:

• Build type: Buildpacks
• Build context directory: /
• Entrypoint: leave blank if Buildpacks uses the included Procfile, or set python -m cafe_mcp_server.server
• Function target: leave blank

Example MCP config

{
  "mcpServers": {
    "cafe-recommendation": {
      "command": "python",
      "args": [
        "-m",
        "cafe_mcp_server.server"
      ],
      "cwd": "/Users/hanlufeng/Desktop/AI-INSIGHT-REPORT/Ceilia/cafe-mcp-server"
    }
  }
}

If the package is installed into the same Python environment used by the MCP client, the console script can be used instead:

{
  "mcpServers": {
    "cafe-recommendation": {
      "command": "cafe-mcp-server"
    }
  }
}

Development

pytest
python -m compileall src tests
PYTHONPATH=src python -c "from cafe_mcp_server.recommender import recommend_coffee; print(recommend_coffee(mood='smooth iced', prefer_milk=False)['name'])"

Command-line MCP tool test

After installing the project, call the MCP server through a stdio client:

python scripts/call_tool.py recommend_coffee --args '{"mood":"smooth iced","prefer_milk":false,"caffeine":"high","temperature":"cold"}'

Expected result includes:

{
  "id": "cold_brew",
  "name": "Cold Brew"
}