MCP Python Tutorial

🚀 MCP Python 教程

本項目是一個使用簡單本地數據庫和模擬數據的 Python 中的 MCP 教程應用程序，能幫助開發者學習 MCP 在 Python 中的應用。

🚀 快速開始

✨ 主要特性

此教程應用程序演示了 MCP 的核心概念，您可以在tutorial_app/mcp_server.py中查看基於角色的註釋，具體功能如下：

• @mcp.resource：基本上，這個註解是關於代理“獲取”資源，就像 REST API 中的GET一樣。
  • users://all - 獲取所有用戶
  • users://{user_id}/profile - 獲取用戶的個人資料
  • posts://all - 獲取所有帖子
  • posts://{post_id} - 通過 ID 獲取帖子
• @mcp.tool：這是關於代理“生成”新資源，就像 REST API 中的POST一樣。
  • create_user - 創建新用戶
  • create_post - 創建新帖子
  • search_posts - 根據標題或內容搜索帖子
• @mcp.prompt：這只是方便與 LLM 交互的可重用模板。
  • user_profile_analysis - 生成用戶的個人資料分析
  • post_feedback - 帖子反饋交互式提示

⚠️ 重要提示

更多註解，請閱讀：https://github.com/modelcontextprotocol/python-sdk?tab=readme-ov-file#核心概念

📦 安裝指南

通過 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 服務器，您需要一個 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 從：

• 鏈接

高級用法

1. 找到或創建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

2. 在claude_desktop_config.json中添加mcpServers屬性：

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

💡 使用建議

注意，您可以部署多個 MCP 服務器，每個服務器都有自己的職責和專業領域，這種關注分離比在單個 MCP 服務器中實現一切更好。