Quickstart Guide to Building an MCP Server in Python

基本能力

产品定位

mcp-server-playbook-2025 是一个用于构建 MCP 服务器的开发工具，旨在帮助开发者快速集成 AI 代理与外部服务。

核心功能

1. 工具定义：支持定义和注册工具（如计算器功能）。
2. 资源定义：支持定义动态资源（如个性化问候功能）。
3. 快速测试：提供 MCP Inspector 工具，方便开发者测试服务器功能。
4. 客户端集成：支持与 AI 助手（如 Claude Desktop）无缝集成。
5. 部署支持：提供部署建议，包括安全、扩展性和监控。

适用场景

1. AI 代理扩展：为 AI 代理添加自定义工具和数据源。
2. 开发测试：快速构建和测试 MCP 服务器功能。
3. 生产部署：部署到生产环境，为 AI 应用提供稳定的外部服务接口。

工具列表

1. MCP Inspector：用于测试和验证 MCP 服务器功能。
2. MCP Python SDK：提供构建 MCP 服务器和客户端的工具。

常见问题解答

1. 如何安装 MCP Python SDK？
2. 推荐使用 uv 包管理器：uv add "mcp[cli]"。
3. 或使用 pip：pip install mcp。
4. 如何测试 MCP 服务器？
5. 使用命令 mcp dev server.py 启动 MCP Inspector。
6. 如何部署 MCP 服务器？
7. 建议使用容器化工具（如 Docker）并实现安全机制（如 API 密钥）。

使用教程

使用依赖

1. 安装 Python 环境。
2. 安装 MCP Python SDK： bash uv add "mcp[cli]" 或 bash pip install mcp

安装教程

1. 创建 Python 文件（如 server.py）。
2. 使用 MCP Python SDK 定义工具和资源： ```python from mcp.server.fastmcp import FastMCP

mcp = FastMCP("Demo Server")

@mcp.tool() def add(a: int, b: int) -> int: """Adds two numbers.""" return a + b

@mcp.resource("greeting://{name}") def get_greeting(name: str) -> str: """Generates a personalized greeting.""" return f"Hello, {name}!"

if name == "main": mcp.run() 3. 运行服务器：bash python server.py ```

调试方式

1. 使用 MCP Inspector 测试服务器： bash mcp dev server.py
2. 检查日志和监控工具以确保服务器正常运行。

许可证

None