MCP Server Template (Python)

基本能力

产品定位

MCP Server Template (Python) 是一个用于快速构建模型上下文协议（MCP）服务器的Python模板，旨在帮助开发者快速创建能够注册和暴露工具及提示的服务器，供AI模型使用。

核心功能

1. 工具和提示的创建：支持通过装饰器快速定义工具和提示，供AI模型调用。
2. 数据库支持：支持连接外部PostgreSQL数据库，提供数据库上下文管理。
3. API工具支持：支持从OpenAPI、Swagger或GraphQL API端点自动生成工具。
4. 多种部署选项：支持Docker部署和云平台部署（如AWS、GCP、Azure等）。
5. 命令行选项：支持自定义端口、调试模式、传输方式（HTTP或stdio）等。

适用场景

1. AI模型开发：为AI模型提供工具和提示的快速集成。
2. 数据库集成：需要与PostgreSQL数据库交互的场景。
3. API集成：需要从外部API自动生成工具的场景。
4. 云部署：需要在云平台上部署MCP服务器的场景。

工具列表

1. 工具创建：通过@mcp.tool()装饰器定义工具，供AI模型调用。
2. 提示创建：通过@mcp.prompt()装饰器定义提示模板。
3. 数据库工具：支持执行SQL查询等数据库操作。
4. API工具：支持从OpenAPI、Swagger或GraphQL API端点自动生成工具。

常见问题解答

1. 如何添加新工具？：在src/main.py中使用@mcp.tool()装饰器定义新工具。
2. 如何配置数据库？：复制.env.example到.env并配置数据库连接信息。
3. 如何部署到云平台？：使用Docker构建镜像后部署到云平台。

使用教程

使用依赖

• Python 3.10或更高版本

安装教程

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

2. 运行服务器： bash python -m src.main # 或使用CLI mcp-server-template

调试方式

1. 更改端口： bash mcp-server-template --port 9000
2. 启用调试模式： bash mcp-server-template --debug
3. 使用stdio传输： bash mcp-server-template --transport stdio
4. 设置日志级别： bash mcp-server-template --log-level debug

许可证

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