MCP Server

🚀 Puch AI的MCP啟動器

這是一個用於創建與Puch AI配合使用的自定義模型上下文協議（MCP）服務器的啟動模板。它配備了現成的求職和圖像處理工具。

🚀 快速開始

本啟動器可幫助你創建與Puch AI配合使用的MCP服務器。以下是快速設置指南：

步驟1：安裝依賴項

首先，確保你已安裝Python 3.11或更高版本。然後執行以下操作：

# 創建虛擬環境
uv venv

# 安裝所有必需的軟件包
uv sync

# 激活環境
source .venv/bin/activate

步驟2：設置環境變量

在項目根目錄下創建一個 .env 文件：

# 複製示例文件
cp .env.example .env

然後編輯 .env 文件並添加你的詳細信息：

AUTH_TOKEN=your_secret_token_here
MY_NUMBER=919876543210

⚠️ 重要提示

• AUTH_TOKEN：這是用於身份驗證的秘密令牌，請妥善保管！
• MY_NUMBER：你的WhatsApp號碼，格式為 {國家代碼}{號碼}（例如，+91-9876543210對應的格式為 919876543210）

步驟3：運行服務器

cd mcp-bearer-token
python mcp_starter.py

你會看到：🚀 Starting MCP server on http://0.0.0.0:8086

步驟4：將服務器公開（Puch要求）

由於Puch需要通過HTTPS訪問你的服務器，你需要將本地服務器公開：

選項A：使用ngrok（推薦）

1. 安裝ngrok：從https://ngrok.com/download 下載。
2. 獲取你的認證令牌：
   • 訪問https://dashboard.ngrok.com/get-started/your-authtoken 。
   • 複製你的認證令牌。
   • 運行：ngrok config add-authtoken YOUR_AUTHTOKEN
3. 啟動隧道：

ngrok http 8086

選項B：部署到雲端

你也可以將其部署到以下服務：

• Railway
• Render
• Heroku
• DigitalOcean App Platform

✨ 主要特性

🎯 求職工具

• 分析職位描述 - 粘貼任何職位描述，獲取智能見解。
• 從URL獲取職位信息 - 提供職位發佈鏈接，獲取完整詳情。
• 搜索職位 - 使用自然語言查找相關職位機會。

🖼️ 圖像處理工具

• 將圖像轉換為黑白圖像 - 上傳任何圖像，獲取單色版本。

🔐 內置認證

• 承載令牌認證（Puch AI要求）。
• 驗證工具，可返回你的電話號碼。

📦 安裝指南

請參考快速開始部分的步驟1至步驟3進行安裝。

💻 使用示例

基礎用法

如果你想使用求職工具分析職位描述，可以這樣做：

# 假設這裡有調用求職工具分析職位描述的代碼示例
# 但原文檔未提供，這裡保持說明邏輯
# 你可以調用相應的函數，傳入職位描述文本，獲取分析結果

高級用法

如果你想添加新的工具，可以按照以下步驟操作：

1. 創建一個新的工具函數：

@mcp.tool(description="Your tool description")
async def your_tool_name(
    parameter: Annotated[str, Field(description="Parameter description")]
) -> str:
    # Your tool logic here
    return "Tool result"

2. 根據需要添加必要的導入。

📚 詳細文檔

官方Puch AI MCP文檔

• 主文檔：https://puch.ai/mcp
• 協議兼容性：支持承載令牌和OAuth的核心MCP規範。
• 命令參考：完整的MCP命令文檔。
• 服務器要求：工具註冊、驗證、HTTPS要求。

技術規範

• JSON-RPC 2.0規範：https://www.jsonrpc.org/specification （用於錯誤處理）
• MCP協議：核心協議消息、工具定義、認證。

支持與不支持的特性

✓ 支持的特性：

• 核心協議消息
• 工具定義和調用
• 認證（承載令牌和OAuth）
• 錯誤處理

✗ 不支持的特性：

• 視頻擴展
• 資源擴展
• 提示擴展

🔧 技術細節

協議相關

• JSON-RPC 2.0規範：用於錯誤處理，詳細信息可參考https://www.jsonrpc.org/specification 。
• MCP協議：包含核心協議消息、工具定義、認證等內容。

支持情況

支持核心協議消息、工具定義和調用、認證（Bearer & OAuth）、錯誤處理；不支持視頻擴展、資源擴展、提示擴展。

📄 許可證

原文檔未提及許可證信息。

尋求幫助

• 加入Puch AI Discord：https://discord.gg/VMCnMvYx
• 查看Puch AI MCP文檔：https://puch.ai/mcp
• Puch WhatsApp號碼：+91 99988 81729

編碼愉快！🚀

在你關於MCP的帖子中使用 #BuildWithPuch 標籤！

這個啟動器讓你為Puch AI創建自己的MCP服務器變得超級容易。只需按照設置步驟操作，你就可以用自定義工具擴展Puch的功能！