MCP Server Template (Python)

基本能力

产品定位

MCP Server Template (Python) 是一个用于快速构建 Model Context Protocol (MCP) 服务器的模板项目，旨在帮助开发者快速创建能够注册和暴露工具和提示的服务器，供 AI 模型使用。

核心功能

1. 工具和提示注册：通过装饰器快速注册工具和提示，供 AI 模型调用。
2. 多种传输方式：支持 HTTP 和 stdio 传输方式。
3. 灵活的部署选项：支持 Docker 部署和云平台部署。
4. 开发工具支持：提供代码格式化、测试和 linting 工具。

适用场景

1. AI 模型开发：为 AI 模型提供工具和提示的注册和调用能力。
2. 快速原型开发：快速构建 MCP 服务器原型。
3. 云平台部署：在 AWS、GCP 或 Azure 等云平台上部署 MCP 服务器。

工具列表

1. 工具注册：通过 @mcp.tool() 装饰器注册工具，供 AI 模型调用。
2. 提示注册：通过 @mcp.prompt() 装饰器注册提示，供 AI 模型使用。
3. 命令行工具：提供丰富的命令行选项，如端口设置、调试模式等。

常见问题解答

1. 如何添加新工具：编辑 src/main.py，使用 @mcp.tool() 装饰器添加新工具。
2. 如何添加新提示：编辑 src/main.py，使用 @mcp.prompt() 装饰器添加新提示。
3. 如何部署：支持 Docker 部署和云平台部署。

使用教程

使用依赖

• Python 3.10 或更高版本

安装教程

1. 克隆仓库： bash git clone https://github.com/nisarg38/mcp-server-template-python.git my-mcp-server cd my-mcp-server
2. 安装开发模式： bash pip install -e ".[dev]"

调试方式

1. 运行服务器： bash python -m src.main 或使用 CLI： bash mcp-server-template
2. 访问服务器：
3. HTTP: http://localhost:8080
4. stdio 传输: mcp-server-template --transport stdio

命令行选项

# 更改端口（默认：8080）
mcp-server-template --port 9000

# 启用调试模式
mcp-server-template --debug

# 使用 stdio 传输
mcp-server-template --transport stdio

# 设置日志级别
mcp-server-template --log-level debug

许可证

该项目遵循 MIT 开源许可条款。