MCP Server using Python, FastMCP and 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

Related MCP server: DDG MCP2

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.