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的功能！