用于Puch AI的MCP起动器
这是一个创建自己的模型上下文协议（MCP）服务器的入门模板，该服务器与Puch AI配合使用。它附带了用于求职和图像处理的现成工具。
什么是MCP？
MCP（模型上下文协议）允许像Puch这样的AI助手安全地连接到外部工具和数据源。把它想象成在不损害安全的情况下给你的人工智能额外的超能力。
这个初学者包括什么？
🎯 求职工具
- 分析职位描述 -粘贴任何职位描述并获得明智的见解
- 从URL获取招聘信息 -提供职位发布链接并获取完整详细信息
- 搜索职位 -使用自然语言寻找相关工作机会
🖼️ 图像处理工具
- 将图像转换为黑白 -上传任何图像并获得单色版本
🔐 内置身份验证
- 承载令牌身份验证（Puch AI要求）
- 返回您的电话号码的验证工具
快速设置指南
步骤1：安装依赖项
首先，确保你安装了Python 3.11或更高版本。然后：
# Create virtual environment
uv venv
# Install all required packages
uv sync
# Activate the environment
source .venv/bin/activate步骤2：设置环境变量
创建一个 .env 项目根目录中的文件：
# Copy the example file
cp .env.example .env然后编辑 .env 并添加您的详细信息：
AUTH_TOKEN=your_secret_token_here
MY_NUMBER=919876543210重要提示：
AUTH_TOKEN：这是您用于身份验证的秘密令牌。保持安全！MY_NUMBER：您的WhatsApp号码格式{country_code}{number}（例如。，919876543210致电+91-9876543210）
步骤3：运行服务器
cd mcp-bearer-token
python mcp_starter.py您将看到： 🚀 Starting MCP server on http://0.0.0.0:8086
第四步：公开（Puch要求）
由于Puch需要通过HTTPS访问您的服务器，因此您需要公开您的本地服务器：
选项A：使用ngrok（推荐）
- 安装ngrok：
下载自https://ngrok.com/download
- 获取您的authtoken：
- 首选https://dashboard.ngrok.com/get-started/your-authtoken - 复制您的authtoken - 运行： ngrok config add-authtoken YOUR_AUTHTOKEN
- 启动隧道：
ngrok http 8086选项B：部署到云端
您还可以将其部署到以下服务中：
- 铁路
- 渲染
- Heroku
- 数字海洋应用平台
如何连接Puch AI
- 打开Puch AI 在您的浏览器中
- 开始新的对话
- 使用connect命令：
/mcp connect https://your-domain.ngrok.app/mcp your_secret_token_here调试模式
要获取更详细的错误消息：
/mcp diagnostics-level debug自定义启动器
添加新工具
- 创建新的工具功能：
@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"- 添加所需的导入 如有需要
📚 其他文档资源
Puch AI MCP官方文档
- 主要文件: https://puch.ai/mcp
- 协议兼容性：支持承载和OAuth的核心MCP规范
- 命令参考：完整的MCP命令文档
- 服务器要求：工具注册、验证、HTTPS要求
技术规格
- JSON-RPC 2.0规范: https://www.jsonrpc.org/specification（用于错误处理）
- MCP协议：核心协议消息、工具定义、身份验证
支持与不支持的功能
✓ 支持：
- 核心协议消息
- 工具定义和调用
- 身份验证（承载和OAuth）
- 错误处理
✗ 不支持：
- 视频扩展
- 资源扩展
- 提示延期
获取帮助
- 加入Puch AI Discord： https://discord.gg/VMCnMvYx
- 查看Puch AI MCP文件： https://puch.ai/mcp
- Puch WhatsApp号码： +91 99988 81729
______________________________________________________________________
编码愉快！ 🚀
使用标签 #BuildWithPuch 在您关于MCP的帖子中！
这个入门程序使为Puch AI创建自己的MCP服务器变得超级容易。只需按照设置步骤操作，您就可以使用自定义工具扩展Puch了！