内容
# MCP Server 使用 Python、FastMCP 和 Render Boilerplate
一个基于 Python 和 FastMCP 构建的模型上下文协议 (MCP) 服务器，旨在部署在 Render 上。
## 特性
- 基于 FastMCP 的 MCP 服务器实现
- 准备在 Render 上部署
- 基于 Python，支持现代异步编程
- 综合工具集成
- 简单的配置和设置
## 快速开始
### 先决条件
- Python 3.11.12+
- pip
- Git
### 本地开发
1. 克隆代码库：
```bash
git clone <your-repo-url>
cd mcp-server-using-py-fastmcp-render-boilerplate
```
2. 创建并激活虚拟环境：
```bash
python -m venv .venv
source .venv/bin/activate # 在 Windows 上: .venv\Scripts\activate
```
3. 安装依赖：
```bash
pip install -r requirements.txt
```
4. 本地运行服务器：
```bash
python main.py
```
### 环境变量
在根目录下创建一个 `.env` 文件：
```env
# 服务器配置
HOST=0.0.0.0
PORT=10000
DEBUG=false
# MCP 配置
MCP_SERVER_NAME=my-mcp-server
# 在此添加您的自定义环境变量
```
## 项目结构
```
mcp-server-using-py-fastmcp-render-boilerplate/
├── main.py # 主要服务器入口点，带有日志记录
├── requirements.txt # Python 依赖（最小 FastMCP 设置）
├── env.example # 环境变量示例
├── .gitignore # Git 忽略规则
├── README.md # 本文件
├── LICENSE # MIT 许可证
├── mcp_server.log # 服务器日志文件（在运行时生成）
└── src/ # 源代码
├── __init__.py
└── tools/ # 自定义 MCP 工具
├── __init__.py
└── example_tools.py # 带有日志记录的回声和计算器工具
```
### 测试
使用 MCP Inspector Tool 测试您的服务器：https://github.com/modelcontextprotocol/inspector
## 在 Render 上部署
该项目可以在 Render 上部署：
1. 将您的 GitHub 代码库连接到 Render
2. 创建一个新的 Web 服务
3. 使用以下设置：
- **构建命令**：`pip install -r requirements.txt`
- **启动命令**：`python main.py`
- **环境**：Python 3
- **MCP_SERVER_NAME**：`my-mcp-server`（如在 env.example 中配置）
- **HOST**：`0.0.0.0`
- **PORT**：10000
- **DEBUG**：false
## 开发
### 添加新工具
1. 在 `src/tools/example_tools.py` 中添加新工具
2. 按照 FastMCP 模式实现您的工具
3. 在 `main.py` 中注册该工具
## 贡献
1. Fork 代码库
2. 创建一个功能分支
3. 进行更改
4. 如果适用，添加测试
5. 提交拉取请求
## 许可证
MIT 许可证 - 详见 LICENSE 文件。
## 支持
如有问题和疑问，请在 GitHub 上打开一个问题。
MCP 市场
