AI导哈

MCP服务器模板

这是一个用于创建与Puch AI兼容的MCP服务器的启动模板，包含作业搜索和图像处理等现成工具。

  • by ankitkrshah30
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 ankitkrshah30/mcp-server

使用说明

用于Puch AI的MCP起动器

这是一个创建自己的模型上下文协议（MCP）服务器的入门模板，该服务器与Puch AI配合使用。它附带了用于求职和图像处理的现成工具。

什么是MCP？

MCP（模型上下文协议）允许像Puch这样的AI助手安全地连接到外部工具和数据源。把它想象成在不损害安全的情况下给你的人工智能额外的超能力。

这个初学者包括什么？

文件夹

  • mcp-bearer-token/
    示例MCP服务器使用 持有者代币 auth（Puch AI要求）。包括：

    • mcp_starter.py
      具有以下功能的最小MCP服务器：
      • 文本输入/输出工具（回声风格处理）
      • 图像输入/输出工具（例如，转换为黑白）
      • 承载令牌验证
    • puch-user-id-mcp-example.py
      演示如何使用的任务管理MCP服务器 puch_user_id （Puch提供的唯一用户标识符）来确定每个用户的任务和数据范围。

  • mcp-google-oauth/
    MCP服务器示例，显示如何实现 OAuth 使用Google进行MCP身份验证/授权。

  • mcp-oauth-github/
    MCP服务器示例，显示如何实现 OAuth 使用GitHub进行MCP身份验证/授权。

快速设置指南

步骤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