mcp-unipile

🚀 单立 MCP 服务器

本项目是一个 MCP 服务器实现，借助 Unipile 可访问多个消息平台的消息。它提供标准化接口，让 AI 模型能与各消息平台的消息进行交互，极大提升了消息处理效率。

🚀 快速开始

环境准备

您需要一个 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

多平台发布

要将项目作为多平台发行，可执行以下命令：

pip wheel -w wheels/ .

开发环境设置

若要设置开发环境，执行以下命令：

pip install -e .

✨ 主要特性

集成 Unipile 消息平台

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

多平台通信能力

借助 Unipile，您可以无缝地与各种社交平台进行交流，包括：

• LinkedIn：与职业联系人互动，发送消息，并通过 Unipile 接口管理您的 LinkedIn 互动。
• WhatsApp：发送和接收消息，管理聊天，并保持与联系人的连接。
• Instagram：与关注者互动，回复直接消息，并管理您的 Instagram 消息。
• Messenger：通过 Facebook Messenger 与朋友和家人沟通。
• Telegram：访问 Telegram 聊天和消息，毫不费力。

Unipile 与这些平台的集成允许统一的通信体验，使管理不同服务的交互变得更加容易。这对于依赖 LinkedIn 进行职业网络建立的用户特别有益，因为它使他们能够利用 AI 功能（如 Claude）来增强他们的沟通策略。

📦 安装指南

Unipile 订阅

要使用 Unipile 服务，需要订阅。开发者并非受 Unipile 资助，只是因为 Unipile 效果好而喜欢使用它。有关订阅和功能的详细信息，请访问 Unipile 消息 API 页面。

Docker 安装

您可以从 Docker Hub 拉取镜像，也可以本地构建。该镜像针对 Linux 平台构建，支持 Linux/amd64 和 Linux/arm64 平台。

多平台发布

使用以下命令将项目作为多平台发行：

pip wheel -w wheels/ .

开发环境安装

设置开发环境，运行：

pip install -e .

💻 使用示例

基础用法

资源访问

服务器公开以下资源：

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

示例提示

获取特定聊天的所有消息，示例提示如下：

获取聊天 ID "chat_123" 的所有消息

高级用法

消息管理工具

服务器提供了 unipile_get_chat_messages 工具用于消息管理：

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

📚 详细文档

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

📄 许可证

该项目根据 MIT 许可证分发。