Unipile MCP 服务器

使用 Unipile 访问多个消息平台的消息的 MCP 服务器。

概述

这是一个实现 Model Context Protocol (MCP) 的服务器，提供与 Unipile 消息平台的集成。该服务器使 AI 模型能够通过标准化接口与来自各种消息平台（手机、邮件、WhatsApp、LinkedIn、Slack、Twitter、Telegram、Instagram、Messenger）的消息进行交互。

有关 Model Context Protocol 及其工作原理的更多信息，请参阅 Anthropic 的 MCP 文档。

Unipile 订阅

要使用 Unipile 服务，需要订阅。我并不是因为 Unipile 而获得报酬；我只是因为 Unipile 有效而喜欢使用它的用户。有关订阅和功能的更多详细信息，请访问 Unipile 消息 API 页面。

通信能力

借助 Unipile，您可以在广泛的社交平台上无缝通信。这包括流行的消息服务，例如：

• LinkedIn：通过 Unipile 界面与专业联系人互动、发送消息并管理您的 LinkedIn 互动。
• WhatsApp：发送和接收消息、管理聊天记录并与联系人保持联系。
• Instagram：与关注者互动、回复私信并管理您的 Instagram 通信。
• Messenger：通过 Facebook Messenger 与朋友和家人沟通。
• Telegram：轻松访问您的 Telegram 聊天和消息。

Unipile 与这些平台的集成提供了统一的通信体验，使跨不同服务的互动管理变得更加容易。这对于依赖 LinkedIn 进行职业网络的用户尤其有益，因为它使他们能够利用 Claude 等 AI 功能来增强他们的沟通策略。

组件

资源

服务器公开以下资源：

• unipile://messages：一个动态资源，提供对连接的消息平台中的消息的访问

示例提示

• 获取聊天中的所有消息：

  Get all messages from chat ID "chat_123"
  

工具

服务器提供了几个用于访问 Unipile 数据的工具：

消息管理工具

• unipile_get_chat_messages
  • 从特定聊天中检索所有消息，并支持分页
  • 输入：chat_id（必填），batch_size（可选，默认值：100）
  • 返回：消息对象数组

设置

您需要一个 Unipile DSN 和 API 密钥。您可以从 Unipile 仪表板中获取这些信息。

环境变量

• UNIPILE_DSN：您的 Unipile DSN（例如 api8.unipile.com:13851）
• UNIPILE_API_KEY：您的 Unipile API 密钥

注意：请确保您的 API 密钥安全，切勿将其提交到版本控制系统。

Docker 安装

您可以选择本地构建镜像或从 Docker Hub 拉取镜像。该镜像是为 Linux 平台构建的。

支持的平台

• Linux/amd64
• Linux/arm64
• Linux/arm/v7

选项 1: 从 Docker Hub 拉取

docker pull buryhuang/mcp-unipile:latest

选项 2: 本地构建

docker build -t mcp-unipile .

运行容器：

docker run \
  -e UNIPILE_DSN=your_dsn_here \
  -e UNIPILE_API_KEY=your_api_key_here \
  buryhuang/mcp-unipile:latest

跨平台发布

要为多个平台发布 Docker 镜像，可以使用 docker buildx 命令。请按照以下步骤操作：

1. 创建一个新的构建器实例（如果你还没有创建的话）:

   docker buildx create --use
   

2. 为多个平台构建并推送镜像:

   docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t buryhuang/mcp-unipile:latest --push .
   

3. 验证指定平台上的镜像是否可用:

   docker buildx imagetools inspect buryhuang/mcp-unipile:latest
   

使用 Claude Desktop

Docker 使用

{
  "mcpServers": {
    "unipile": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "UNIPILE_DSN=your_dsn_here",
        "-e",
        "UNIPILE_API_KEY=your_api_key_here",
        "buryhuang/mcp-unipile:latest"
      ]
    }
  }
}

开发

要设置开发环境：

pip install -e .

许可证

本项目根据 MIT 许可证许可。