Unipile MCP 服务器

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

概述

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

有关模型上下文协议及其工作原理的更多信息，请参阅 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: 一个动态资源，提供对来自连接的消息平台的消息的访问

示例提示

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

  获取聊天 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 许可证的许可。