消息平台集成工具

纽带

MCP服务器，允许AI代理访问消息传递平台。一个二进制，五个平台。

Telegram · Gmail · WhatsApp · Slack · Discord

Nexus实现了 模型上下文协议 （MCP）超过stdio，暴露 48工具 让AI代理通过统一的界面跨平台读取、发送、搜索和管理消息。

内置纯Rust。无MCP SDK依赖关系——手工制作JSON-RPC 2.0。单二进制，~4MB版本。

为什么选择Nexus？

AI代理需要进行通信。他们需要阅读你的Telegram消息、发送电子邮件、搜索Slack历史记录和管理Discord频道，但每个平台都有自己的API、身份验证流和数据模型。

Nexus将所有这些统一在MCP背后。将其连接到 克劳德代码, 克劳德桌面，或任何MCP客户端，您的代理可以即时访问您的消息世界。

代理可以用Nexus做什么：

• 在所有平台上读取和发送消息
• 搜索聊天记录（查找几个月前的消息）
• 管理电子邮件（存档、标签、星号、草稿、带附件发送）
• 转发、固定、响应、编辑和删除Telegram消息
• 创建Slack频道、设置主题、管理反应
• 列出不和谐公会，创建线程，固定消息
• 从任何平台下载媒体和附件

快速开始

1.安装

来源：

git clone https://github.com/santoshakil/nexus.git
cd nexus
cargo build --release
cp target/release/nexus ~/.local/bin/

先决条件：

• 锈蚀1.75+
• TDLib(libtdjson.so)--只需要Telegram支持。看 TDLib构建说明.

2.配置

复制示例env文件并填写所需的平台：

cp .env.example .env

您只需配置要使用的平台。Nexus默默地跳过未配置的平台。

# Telegram (get from https://my.telegram.org)
TELEGRAM_API_ID=12345678
TELEGRAM_API_HASH=abcdef1234567890abcdef1234567890

# Gmail (generate App Password at https://myaccount.google.com/apppasswords)
GMAIL_ADDRESS=you@gmail.com
GMAIL_APP_PASSWORD=xxxx xxxx xxxx xxxx

# WhatsApp Business Cloud API (https://developers.facebook.com)
WHATSAPP_ACCESS_TOKEN=your_token
WHATSAPP_PHONE_NUMBER_ID=your_phone_id

# Slack (create app at https://api.slack.com/apps)
SLACK_BOT_TOKEN=xoxb-your-bot-token

# Discord (create app at https://discord.com/developers/applications)
DISCORD_BOT_TOKEN=your_bot_token

3.验证电报（一次性）

Telegram首次需要交互式登录：

nexus auth telegram

这将提示您输入电话号码、短信代码和可选的2FA密码。会话已保存到 ~/.nexus/tdlib/ 并自动重复使用。

4.连接到克劳德代码

添加到您的Claude Code MCP配置中(~/.claude/claude_code_config.json):

{
  "mcpServers": {
    "nexus": {
      "command": "nexus",
      "args": ["mcp"],
      "env": {
        "TELEGRAM_API_ID": "12345678",
        "TELEGRAM_API_HASH": "abcdef1234567890abcdef1234567890",
        "GMAIL_ADDRESS": "you@gmail.com",
        "GMAIL_APP_PASSWORD": "xxxx xxxx xxxx xxxx"
      }
    }
  }
}

或者选择Claude Desktop(claude_desktop_config.json):

{
  "mcpServers": {
    "nexus": {
      "command": "/path/to/nexus",
      "args": ["mcp"],
      "env": {
        "TELEGRAM_API_ID": "12345678",
        "TELEGRAM_API_HASH": "abcdef1234567890abcdef1234567890"
      }
    }
  }
}

工具

Nexus动态公开工具——只有配置平台的工具才会出现在 tools/list.

通用工具（所有平台）

电报工具（13）

Gmail工具（13）

Slack工具（9）

Discord工具（6）

WhatsApp工具（1）

WhatsApp商务云API仅限于发送。消息历史记录无法通过API获得。

格式系统

每个数据返回工具都接受一个可选 format 参数：

示例：

紧凑型（默认）：

[Jan 15 10:30] John Doe (@john): Hey, I was thinking about the architecture for the new...  (id:123456)

扩大：

[Jan 15 10:30] John Doe (@john): Hey, I was thinking about the architecture for the new messaging service. We should probably use a hexagonal pattern with ports and adapters. What do you think? (id:123456)

满：

{"id":"123456","platform":"telegram","channel_id":"-100123","sender":"John Doe","text":"Hey, I was thinking about...","timestamp":1705312200,...}

建筑

六角形（端口和适配器），带9个工作区板条箱：

app-mcp ──→ mod-messaging ──→ core-domain ──→ core-error
                  ↑                 ↑
        infra-tdlib          (port traits)
        infra-google
        infra-whatsapp
        infra-slack
        infra-discord

MCP协议

Nexus使用 stdio上以换行符分隔的JSON-RPC 2.0 （不是Content-Length标头）。stdout专门用于JSON-RPC响应。所有日志记录都通过以下方式发送到stderr tracing.

错误处理

每个错误都包含上下文，以帮助AI代理恢复：

{
  "isError": true,
  "content": [{"type": "text", "text": "[auth] Telegram session expired | try: re-run `nexus auth telegram` | retryable: false"}]
}

错误包括建议（可操作的修复）和操作是否可重试。

平台设置指南

电报

1. 首选 my.telegram.org 并创建应用程序
2. 注意你的 API_ID 和 API_HASH
3. 设置环境变量：
   复制

   export TELEGRAM_API_ID=12345678
   export TELEGRAM_API_HASH=abcdef1234567890abcdef1234567890
   

4. 运行一次性身份验证：
   复制

   nexus auth telegram
   

   输入您的电话号码、短信代码和2FA密码（如果已启用）。
5. 会话已保存到 ~/.nexus/tdlib/ --除非撤销会话，否则您不需要再次进行身份验证。

注： Telegram需要 TDLib (libtdjson.so)安装在 /usr/local/lib。请参阅 TDLib构建指南 为了你的平台。集 TDLIB_DIR env-var（如果安装在其他地方）。

Gmail

1. 在您的Google帐户上启用两步验证
2. 在以下位置生成应用程序密码 myaccount.google.com/apppasswords
   • 选择“邮件”作为应用程序
   • 复制16个字符的密码
3. 设置环境变量：
   复制

   export GMAIL_ADDRESS=you@gmail.com
   export GMAIL_APP_PASSWORD="xxxx xxxx xxxx xxxx"
   

Gmail搜索语法： 这 search 工具接受IMAP条件：

• 简单文本： "meeting notes" （搜索正文）
• 发件人： FROM sender@example.com
• 按主题： SUBJECT "quarterly report"
• 截止日期： SINCE 01-Jan-2025
• 仅未读： UNSEEN
• 合并： FROM boss@company.com SINCE 01-Feb-2025 UNSEEN

WhatsApp

1. 创建一个 元开发人员 账户
2. 使用WhatsApp产品创建新应用程序
3. 从WhatsApp API仪表板获取您的访问令牌和电话号码ID
4. 设置环境变量：
   复制

   export WHATSAPP_ACCESS_TOKEN=your_token
   export WHATSAPP_PHONE_NUMBER_ID=your_phone_id
   

限制： WhatsApp商务云API仅支持发送消息。无法通过API读取消息历史记录或搜索消息。

Slack

1. 首选 api.slack.com/apps 并创建新应用程序
2. 在...之下 OAuth和权限，添加以下bot令牌范围：
   • channels:history, channels:read, channels:write
   • chat:write
   • groups:history, groups:read
   • im:history, im:read
   • mpim:history, mpim:read
   • reactions:read, reactions:write
   • users:read
   • files:write （用于文件上传）
3. 将应用程序安装到您的工作区
4. 复制Bot用户OAuth令牌(xoxb-...)
5. 设置环境变量：
   复制

   export SLACK_BOT_TOKEN=xoxb-your-bot-token
   

Discord 的中文翻译是“不和谐”或“纷争”。

1. 首选 confirm.com/developers/applications
2. 创建一个新应用
3. 首选 机器人 选项卡并创建bot
4. 启用这些特权网关意图： 消息内容意图
5. 复制机器人令牌
6. 使用OAuth2 URL生成器将机器人邀请到您的服务器 bot 范围和这些权限：
   • 阅读消息/查看频道
   • 发送消息
   • 管理消息（用于固定/删除）
   • 添加反应
   • 读取消息历史记录
   • 创建公共线程
7. 设置环境变量：
   复制

   export DISCORD_BOT_TOKEN=your_bot_token
   

CLI参考

# Start the MCP server (default command)
nexus mcp

# Authenticate with Telegram (interactive, one-time)
nexus auth telegram

# Show help and environment variables
nexus help

环境变量

从源头构建

# Debug build
cargo build --workspace

# Release build (optimized, ~4MB)
cargo build --release

# Check/lint
cargo check --workspace
cargo clippy --workspace -- -D warnings

# Run protocol tests (needs debug build)
cargo build --workspace
bash tests/mcp_protocol_test.sh

生成配置

发布配置文件针对小二进制大小进行了优化：

• LTO：脂肪（链接时间优化）
• 编码单元：1
• 条带：已启用
• 恐慌：流产

工作区过梁

这些规定适用于所有板条箱：

• clippy::unwrap_used = "deny" --使用 ? 或 match
• clippy::expect_used = "deny" --使用 ? 或 match
• unused_must_use = "deny"
• unsafe_code = "warn" （仅允许进入 infra-tdlib FFI）

添加新平台

1. 创建 crates/infra-{name}/ 随着 Cargo.toml 和 src/adapter.rs
2. 添加变体 Platform 枚举在 core-domain/src/entities.rs
3. 实施 MessagingPort 性状（6种方法）
4. 可选地在中添加扩展特性 core-domain/src/ports.rs
5. 在中注册适配器 app-mcp/src/main.rs
6. 在中添加工具定义 app-mcp/src/mcp/tools.rs
7. 电汇 app-mcp/src/mcp/server.rs

添加新工具

1. 将该方法添加到中的相关扩展特征中 core-domain/src/ports.rs
2. 在适配器中实现它（例如。， infra-tdlib/src/adapter.rs)
3. 添加一个 ToolDef 在 app-mcp/src/mcp/tools.rs
4. 在中添加调度臂 app-mcp/src/mcp/server.rs

贡献

欢迎捐款。拜托：

1. 分叉仓库并创建功能分支
2. 确保 cargo clippy --workspace -- -D warnings 无警告通过
3. 确保 cargo check --workspace 编译干净
4. 跑 bash tests/mcp_protocol_test.sh （需要调试版本）
5. 保持提交原子性和描述性
6. 打开一个带有清晰描述的拉取请求

许可证

麻省理工学院——见 许可证 了解详情。