Content
# 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
## Quick Start
### Prerequisites
- Python 3.11.12+
- pip
- Git
### Local Development
1. Clone the repository:
```bash
git clone <your-repo-url>
cd mcp-server-using-py-fastmcp-render-boilerplate
```
2. Create and activate a virtual environment:
```bash
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
```
3. Install dependencies:
```bash
pip install -r requirements.txt
```
4. Run the server locally:
```bash
python main.py
```
### Environment Variables
Create a `.env` file in the root directory:
```env
# 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.
MCP Store