YaVendió 工具集

YaVendió Tools 是一个基于 MCP(模型上下文协议)的消息和通知系统,允许 AI 系统通过 MCP 与各种消息平台进行交互。该项目实现了一个 MCP 服务器,提供了发送文本、图像、文档、按钮和警报等消息工具。

  • by YaVendio
  • 更新于
在 GitHub 查看 YaVendio/ya-tools

使用说明

产品定位

YaVendió Tools 是一个基于 MCP 的消息和通知系统,旨在为 AI 系统提供与各种消息平台的无缝集成。

核心功能

  • 消息能力:

    • 通过 WhatsApp 和其他平台发送文本消息
    • 发送带有适当格式的图像和媒体
    • 发送带有适当元数据的视频
    • 发送带有文件名和元数据的文档
    • 创建交互式按钮以增强用户参与
  • WhatsApp 客户端管理:

    • 使用不同凭据注册和管理多个 WhatsApp 客户端
    • 使用 Infisical 安全存储令牌
    • 无状态架构的客户端管理
    • 每个 WhatsApp 操作的专用工具
  • 通知功能:

    • 配置跨多个渠道(WhatsApp、电子邮件、短信)的警报
    • 支持支付按钮和交易通知
  • 对话管理:

    • 跟踪消息传递状态和元数据
  • 其他实用工具:

    • 睡眠/延迟功能用于定时交互
    • 公司和用户的配置管理
    • 实时消息传递与状态跟踪

适用场景

  • AI 系统与消息平台的集成
    • 通过 WhatsApp 直接向用户发送消息
    • 上传和发送媒体文件
    • 创建带有按钮的交互式体验
    • 高效管理对话上下文
    • 触发多渠道通知

使用教程

使用依赖

# 安装 uv(如果没有)
curl -L https://github.com/astral-sh/uv/releases/latest/download/install.sh | sh

# 或者使用 pip 安装
pip install uv

安装教程

# 克隆仓库
git clone https://your-repo-url/yatools.git
cd yatools

# 安装所有依赖(包括开发依赖)
make sync
# 或者单独安装
make install      # 常规依赖
make dev-install  # 开发依赖

调试方式

# 开发模式(自动重载)
make run

# 生产模式
make run-prod

# 使用特定端口运行
PORT=8080 make run