AI导哈

语言学习MCP服务器

一个用于Puch AI的模型上下文协议（MCP）服务器模板，提供语言学习和图像处理工具。

  • by VipulGhodke
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 vipulghodke/mcpserver

使用说明

Puch AI语言学习MCP服务器

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

什么是MCP？

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

这个初学者包括什么？

🌍 语言学习辅助工具

  • 翻译帮助 -用语法解释在语言之间翻译文本
  • 语法解释 -获取语法规则和概念的详细解释
  • 实践练习 -接收针对不同技能水平的定制练习
  • 学习资源 -查找推荐的应用程序、网站和学习材料

🃏 词汇练习工具

  • 闪卡 -为任何语言和类别创建词汇抽认卡
  • 测验 -生成词汇测验来测试你的知识
  • 单词列表 -按类别和难度获取有组织的单词列表
  • 填写空白练习 -通过互动练习进行练习

🖼️ 图像处理工具

  • 将图像转换为黑白 -上传任何图像并获得单色版本

🔐 内置身份验证

  • 承载令牌身份验证（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：

  • 将“你好吗？”翻译成西班牙语
  • “用法语解释过去时”
  • “给我一个日语初学者词汇测验”
  • “用意大利语制作食物词汇抽认卡”
  • “查找学习德语的资源”
  • “给我一个中级西班牙语练习题”

📚 其他文档资源

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服务器变得非常容易。只需按照设置步骤操作，您就可以使用自定义工具帮助用户学习新语言了！

相关 MCP