Python MCP Server Starter Template

基本能力

产品定位

Python MCP Server Starter Template 是一个用于快速创建基于 MCP 协议的 Python 应用程序的模板项目，旨在简化开发流程并提高开发效率。

核心功能

• 使用 mcp Python SDK (FastMCP) 实现 MCP 服务器
• 暴露 MCP 工具（可由 LLM 调用的函数）和 资源（可由 LLM 访问的数据）
• 模块化架构
• 简单的工具和资源注册
• 可自定义的命令行接口
• 生产环境部署支持
• 内置调试能力（支持 VS Code 集成）
• 开发工具配置（使用 uv 进行环境和包管理）
• Docker 容器化部署支持

适用场景

• 快速开发基于 MCP 协议的 Python 应用程序
• 为 LLM 提供工具和资源接口
• 开发和生产环境部署

工具列表

• MCP Inspector：用于测试和调试 MCP 服务器的可视化工具
• uv：用于环境和包管理
• Docker：用于容器化部署

常见问题解答

• 调试模式不应在生产环境中使用：调试模式会暴露网络端口，可能存在安全风险。
• 确保使用正确的 Python 解释器：在 VS Code 中调试时，需选择虚拟环境中的 Python 解释器。

使用教程

使用依赖

• Python 3.10 或更高版本
• uv（推荐用于环境和包管理）
• MCP Inspector（推荐用于测试/调试 MCP 服务器）
• [可选] Git
• [可选] Docker（用于容器化部署）

安装教程

1. 克隆或使用模板： shell git clone https://github.com/ltwlf/python-mcp-starter.git your-repo-name cd your-repo-name
2. 重命名项目：
3. 重命名 hello_mcp_server 目录为你的 Python 包名
4. 替换 hello-mcp-server 和 hello_mcp_server 为你的项目名
5. 更新 APP_ID 和 .vscode/launch.json 文件
6. 创建虚拟环境： shell uv venv .venv\Scripts\Activate.ps1 # Windows PowerShell # 或 source .venv/bin/activate # Linux/macOS
7. 安装依赖： shell uv pip install -e ".[dev]"

调试方式

1. 使用 uv run 或 mcp CLI 工具运行服务器： shell uv run your-script-name # stdio 模式 mcp dev ./your_package_name/server.py # stdio 模式 uv run your-script-name --sse # SSE 模式
2. 使用 VS Code 调试：
3. 运行 uv run mcp-debug

4. 在 VS Code 中选择 "Attach to MCP worker" 配置并启动调试器

5. Docker 部署： bash docker-compose up -d # 或 docker build -t your-image-name . docker run -p 8000:8000 your-image-name

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。