InteractionCo/mcp-server-template

MCP Server Template

A minimal FastMCP server template for Render deployment with streamable HTTP transport.

Local Development

Setup

Fork the repo, then run:

git clone <your-repo-url>
cd mcp-server-template
conda create -n mcp-server python=3.13
conda activate mcp-server
pip install -r requirements.txt

Test

python src/server.py
# then in another terminal run:
npx @modelcontextprotocol/inspector

Open http://localhost:3000 and connect to http://localhost:8000/mcp using "Streamable HTTP" transport (NOTE THE /mcp!).

Deployment

Option 1: One-Click Deploy

Click the "Deploy to Render" button above.

Option 2: Manual Deployment

1. Fork this repository
2. Connect your GitHub account to Render
3. Create a new Web Service on Render
4. Connect your forked repository
5. Render will automatically detect the render.yaml configuration

Your server will be available at https://your-service-name.onrender.com/mcp (NOTE THE /mcp!)

Poke Setup

You can connect your MCP server to Poke at (poke.com/settings/connections)[poke.com/settings/connections]. To test the connection explitly, ask poke somethink like Tell the subagent to use the "{connection name}" integration's "{tool name}" tool. If you run into persistent issues of poke not calling the right MCP (e.g. after you've renamed the connection) you may send clearhistory to poke to delete all message history and start fresh. We're working hard on improving the integration use of Poke :)

Customization

Add more tools by decorating functions with @mcp.tool:

@mcp.tool
def calculate(x: float, y: float, operation: str) -> float:
    """Perform basic arithmetic operations."""
    if operation == "add":
        return x + y
    elif operation == "multiply":
        return x * y
    # ...