AI导哈

MCP服务器模板

一个用于创建与Puch AI兼容的MCP服务器的模板，包含求职搜索和图像处理工具。

  • by Chandrahas455
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 chandrahas455/comicstripmcp

使用说明

用于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（推荐）

  1. 安装ngrok： 下载自https://ngrok.com/download

  2. 获取您的authtoken：

    • 首选https://dashboard.ngrok.com/get-started/your-authtoken
    • 复制您的authtoken
    • 运行： ngrok config add-authtoken YOUR_AUTHTOKEN

  3. 启动隧道：

    ngrok http 8086

选项B：部署到云端

您还可以将其部署到以下服务中：

  • 铁路
  • 渲染
  • Heroku
  • 数字海洋应用平台

如何连接Puch AI

  1. 打开Puch AI 在您的浏览器中
  2. 开始新的对话
  3. 使用connect命令：
    /mcp connect https://your-domain.ngrok.app/mcp your_secret_token_here

调试模式

要获取更详细的错误消息：

/mcp diagnostics-level debug

自定义启动器

添加新工具

  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）
  • 错误处理

✗ 不支持：

  • 视频扩展
  • 资源扩展
  • 提示延期

获取帮助

  • 加入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了！

相关 MCP