MCP Python Tutorial

MCP Python 教程

使用 Python 编写的 MCP 教程应用程序，带有简单的本地数据库和模拟数据

安装和运行

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Python MCP 教程服务器：

手动安装

1. 克隆此存储库
2. 安装依赖项：

3. 以开发模式运行 MCP 服务器：

4. MCP 服务器默认端口为5173 。访问http://localhost:5173 。

MCP 功能

本教程演示了 MCP 的核心概念。你可以在tutorial_app/mcp_server.py中查看每个角色的注解：

@mcp.resource

基本上，这个注释是关于代理“获取”资源，就像 RESTAPI 中的GET一样。

• users://all - 获取所有用户
• users://{user_id}/profile - 获取用户的个人资料
• posts://all - 获取所有帖子
• posts://{post_id} - 通过 ID 获取帖子

@mcp.tool

这是关于代理“生成”新资源，就像 RESTAPI 中的POST一样。

• create_user创建新用户
• create_post创建新帖子
• search_posts - 按标题或内容搜索帖子

@mcp.prompt

这只是一个可重复使用的模板，以便于与 LLM 方便地交互。

• user_profile_analysis - 生成用户个人资料的分析
• post_feedback - 帖子反馈的交互式提示

[!NOTE] 有关更多注释，请阅读： https://github.com/modelcontextprotocol/python-sdk? tab=readme-ov-file#core-concepts

连接到客户端

设置好 MCP 服务器后，您需要一个 LLM 客户端，该客户端将使用 MCP 服务器来构建代理。以下指南将帮助您使用Claude Desktop作为客户端进行连接。

1. Claude Desktop 使用uv安装 MCP 服务器依赖项。首先，安装uv ：

2. 使用uv安装 MCP 服务器依赖项：

3. 下载 Claude Desktop 请访问：

• https://claude.ai/download

4. 找到或创建claude_desktop_config.json文件。具体位置因操作系统而异：

• 视窗：

• MacOS/Linux：

5. 将mcpServers属性添加到您的claude_desktop_config.json中：

注意：您可以部署多个 MCP 服务器，每个服务器都有各自的关注点和专长。这种关注点分离比将所有功能都集成到单个 MCP 服务器中效果更好。

6. 重新启动 Claude Desktop。