MCP Python 教程

使用简单本地数据库和模拟数据的Python中的MCP教程应用程序

安装与运行

通过Smithery安装

要通过Smithery自动安装Claude桌面版的Python MCP教程服务器：

npx -y @smithery/cli install @jhj0517/mcp-python-tutorial --client claude

手动安装

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

pip install -r requirements.txt

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

mcp dev localdb_app.py

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#核心概念

连接到客户端

一旦设置了MCP服务器，您需要一个LLM客户端来使用您的MCP服务器构建代理。以下指南将帮助您使用Claude Desktop作为客户端。

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

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

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

# 创建虚拟环境并激活它
uv venv
.venv\Scripts\activate

uv pip install -r requirements.txt

3. 下载Claude Desktop从：

• 链接

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

• Windows:

C:\Users\%USER%\AppData\Roaming\Claude\claude_desktop_config.json

• MacOS/Linux:

~/Library/Application\ Support/Claude/claude_desktop_config.json

5. 在claude_desktop_config.json中添加mcpServers属性：

{
    "mcpServers": {
        "local_db": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather",
                "run",
                "localdb_app.py"
            ]
        }
    }
}

注意：您可以部署多个MCP服务器，每个服务器都有自己的职责和专业领域。
这种关注分离比在单个MCP服务器中实现一切更好。