FastMCP Render Boilerplate

A Model Context Protocol (MCP) server built with Python, FastMCP, designed to be deployed on Render.

Features

• FastMCP-based MCP server implementation
• Ready for deployment on Render
• Python-based with modern async support
• Comprehensive tool integration
• Easy configuration and setup

Quick Start

Prerequisites

• Python 3.11.12+
• pip
• Git

Local Development

1. Clone the repository:

git clone <your-repo-url>
cd mcp-server-using-py-fastmcp-render-boilerplate

2. Create and activate a virtual environment:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Install dependencies:

pip install -r requirements.txt

4. Run the server locally:

python main.py

Environment Variables

Create a .env file in the root directory:

# Server Configuration
HOST=0.0.0.0
PORT=10000
DEBUG=false

# MCP Configuration
MCP_SERVER_NAME=my-mcp-server

# Add your custom environment variables here

Project Structure

mcp-server-using-py-fastmcp-render-boilerplate/
├── main.py                 # Main server entry point with logging
├── requirements.txt        # Python dependencies (minimal FastMCP setup)
├── env.example             # Example environment variables
├── .gitignore             # Git ignore rules
├── README.md              # This file
├── LICENSE                # MIT License
├── mcp_server.log         # Server log file (generated at runtime)
└── src/                   # Source code
    ├── __init__.py
    └── tools/             # Custom MCP tools
        ├── __init__.py
        └── example_tools.py  # Echo and calculator tools with logging

Testing

Make use of the MCP Inspector Tool to test your server: https://github.com/modelcontextprotocol/inspector

Deployment on Render

This project can be deployed on Render:

1. Connect your GitHub repository to Render
2. Create a new Web Service
3. Use the following settings:
   • Build Command: pip install -r requirements.txt
   • Start Command: python main.py
   • Environment: Python 3
   • MCP_SERVER_NAME: my-mcp-server (as configured in env.example)
   • HOST: 0.0.0.0
   • PORT: 10000
   • DEBUG: false

Development

Adding New Tools

1. Add a new tool to src/tools/example_tools.py
2. Implement your tool following the FastMCP pattern
3. Register the tool in main.py

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

License

MIT License - see LICENSE file for details.

Support

For issues and questions, please open an issue on GitHub.