Agenticledger MCP Slack

Slack MCP服务器

AgentLedger平台集成 版本： 1.0.0

概述

Slack MCP服务器使AI代理能够通过标准化的模型上下文协议（MCP）工具与Slack工作区进行交互。此服务器提供读取消息、发布更新、管理线程和发现通道的访问权限，同时遵循AgentLedger平台安全和身份验证标准。

用真实的Slack数据验证-所有核心功能都经过测试并正常工作！ ✅

身份验证模式

✅ OAuth（直接访问令牌）

此服务器直接使用Slack的OAuth令牌。该平台处理OAuth流和令牌管理——服务器只需接收和使用访问令牌。

令牌格式

accessToken: "xoxb-..." // Bot token (recommended)

所需松弛范围

您的Slack应用程序需要以下OAuth作用域：

核心功能所需：

• channels:history -查看公共频道中的消息
• groups:history -查看私人频道中的消息
• im:history -查看直接消息中的消息
• mpim:history -查看群直接消息中的消息
• channels:read -查看基本频道信息
• groups:read -查看基本私人频道信息
• users:read -查看用户信息
• chat:write -在频道和对话中发布消息

可用工具

1.对话_历史

说明： 从支持分页的Slack频道、DM或线程中检索消息历史记录

✅ 经过测试并使用真实的Slack数据！

参数：

• accessToken （字符串，必填）：Slack OAuth令牌（xoxb-…）
• channel_id （字符串，必填）：频道ID（例如C1234567890）、频道名称（#general）或DM（@username）
• limit （string | number，可选）：时间范围（1d、7d、1m、90d）或消息计数（例如100）
• cursor （字符串，可选）：来自上一个响应的分页光标
• include_activity_messages （布尔值，可选）：包括加入/离开系统消息（默认值：false）

例子：

{
  "accessToken": "xoxb-...",
  "channel_id": "#testing",
  "limit": 10
}

答复：

{
  "success": true,
  "data": {
    "messages": [
      {
        "type": "message",
        "user": "U1234567890",
        "text": "Hello world!",
        "ts": "1234567890.123456"
      }
    ],
    "has_more": false,
    "cursor": "",
    "channel_id": "C1234567890"
  }
}

______________________________________________________________________

2.对话回复

说明： 按通道和线程时间戳获取特定线程中的所有消息

✅ 经过测试并使用真实线程！

参数：

• accessToken （字符串，必填）：Slack OAuth令牌
• channel_id （字符串，必填）：通道ID、名称（#general）或DM（@username）
• thread_ts （字符串，必填）：消息时间戳格式为1234567890.123456
• limit （string | number，可选）：时间范围或消息计数
• cursor （字符串，可选）：分页光标
• include_activity_messages （布尔值，可选）：包括系统消息（默认值：false）

例子：

{
  "accessToken": "xoxb-...",
  "channel_id": "#testing",
  "thread_ts": "1234567890.123456",
  "limit": 50
}

答复：

{
  "success": true,
  "data": {
    "messages": [
      {
        "type": "message",
        "user": "U1234567890",
        "text": "Thread parent message",
        "ts": "1234567890.123456",
        "thread_ts": "1234567890.123456"
      },
      {
        "type": "message",
        "user": "U9876543210",
        "text": "Thread reply",
        "ts": "1234567890.234567",
        "thread_ts": "1234567890.123456"
      }
    ],
    "has_more": false,
    "channel_id": "C1234567890",
    "thread_ts": "1234567890.123456"
  }
}

______________________________________________________________________

3.对话_添加_消息

说明： 将消息发布到频道、线程或DM。支持markdown和纯文本格式。

✅ 通道和线程都经过测试和工作！

⚠️ 安全注意事项： 这个工具是 默认禁用。要启用，请设置 SLACK_MCP_ADD_MESSAGE_TOOL 环境变量为：

• * -为所有频道启用
• C1234567890,C9876543210 -为特定通道ID启用（逗号分隔）

参数：

• accessToken （字符串，必填）：带聊天功能的Slack OAuth令牌：写入作用域
• channel_id （字符串，必填）：目标通道ID、名称（#general）或DM（@username）
• thread_ts （string，可选）：线程时间戳；省略直接发布到频道
• payload （字符串，必填）：要发布的消息内容
• content_type （字符串，可选）：“text/markdown”（默认）或“text/plain”

示例-发布到频道：

{
  "accessToken": "xoxb-...",
  "channel_id": "#general",
  "payload": "Hello from AI agent! 👋",
  "content_type": "text/markdown"
}

示例-帖子到线程：

{
  "accessToken": "xoxb-...",
  "channel_id": "#general",
  "thread_ts": "1234567890.123456",
  "payload": "Reply in thread"
}

答复：

{
  "success": true,
  "data": {
    "ok": true,
    "channel": "C1234567890",
    "ts": "1234567890.123456",
    "message": {
      "text": "Hello from AI agent! 👋",
      "type": "message"
    }
  }
}

______________________________________________________________________

4.频道列表

说明： 按类型（公共、私人、DM、组DM）列出工作区频道，并可选择流行度排序

✅ 经过测试并使用真实的工作空间数据！

参数：

• accessToken （字符串，必填）：Slack OAuth令牌
• channel_types （字符串，必填）：逗号分隔值： mpim, im, public_channel, private_channel
• sort （字符串，可选）：“流行度”按成员数排序
• limit （数字，可选）：结果数量（最大值：999，默认值：100）
• cursor （字符串，可选）：分页光标

例子：

{
  "accessToken": "xoxb-...",
  "channel_types": "public_channel,private_channel",
  "sort": "popularity",
  "limit": 50
}

答复：

{
  "success": true,
  "data": {
    "channels": [
      {
        "id": "C1234567890",
        "name": "general",
        "topic": "Company-wide announcements",
        "purpose": "This channel is for team-wide communication",
        "member_count": 150,
        "is_private": false,
        "is_channel": true,
        "is_im": false,
        "is_mpim": false
      }
    ],
    "has_more": false
  }
}

______________________________________________________________________

安装

# Install dependencies
npm install

# Build the TypeScript project
npm run build

# Run the server
npm start

测试

# Run all tests
npm test

# Run integration tests (requires valid Slack token)
npm run test:integration

平台集成说明

环境变量

• SLACK_MCP_ADD_MESSAGE_TOOL -控制消息发布功能：

- 未设置（默认）：邮件发布已禁用 - *：为所有通道启用 - C123...,C456...：为特定通道ID启用

错误处理

服务器为常见的Slack API错误提供特定的错误消息：

• channel_not_found → “使用提供的ID找不到频道”
• invalid_auth → “无效或过期的身份验证凭据”
• not_in_channel → “Bot不是此频道的成员”
• missing_scope → “令牌缺少必需的Slack权限/范围”
• rate_limited → “费率受Slack API限制-请稍后再试”

速率限制

Slack API有费率限制。服务器可以很好地处理速率限制错误，但请考虑在代理代码中实现重试逻辑。

通道ID分辨率

服务器会自动解析：

• 频道名称： #general → C1234567890
• DM用户名： @username → 打开/查找DM并返回通道ID
• 直接ID： C1234567890 → 按原样使用

技术规格

• Node.js版本: ≥18.0.0
• 依赖项:

- @slack/web-api -Slack Web API官方客户端 - @modelcontextprotocol/sdk -MCP协议实现 - zod -架构验证

• 语言：TypeScript（ES2022）
• 运输：标准（MCP标准）

已知限制

1. 机器人频道成员资格： 在阅读消息之前，必须将Bot添加到频道中（使用 /invite @bot-name 在Slack中）
2. 信息发布安全： 默认情况下禁用-需要显式的环境变量配置
3. 费率限制： Slack对API调用强制执行速率限制-实现生产使用的重试逻辑

真实世界测试结果

此服务器已使用实际的Slack工作区数据进行了测试：

验证能力：

• ✅ 阅读来自真实渠道的5+条消息
• ✅ 成功读取2条消息线程
• ✅ 向频道发布消息（现场测试）
• ✅ 发布线程回复（实时测试）
• ✅ 列出了12个真实的工作空间频道
• ✅ 按受欢迎程度对频道进行排序（614→143→23名成员。..)
• ✅ 所有错误处理都经过真实错误测试
• ✅ 所有操作在300ms以下的性能

什么有效：

• 4/4工具与真正的Slack API一起充分发挥功能✅
• 所有核心读写能力均已验证✅
• 渠道发现和管理工作✅

看 REAL_TEST_RESULTS.md 获取完整的测试文档。

平台配置建议

对于AgentLedger集成：

1. OAuth设置：使用上面列出的所需范围配置您的Slack OAuth应用程序
2. 令牌存储：将令牌安全地存储在平台的凭据管理系统中
3. 速率限制：实现平台级速率限制和重试逻辑
4. 错误监视：监视身份验证和权限错误
5. 审计日志：记录所有邮件发布操作以符合要求

______________________________________________________________________

为AgentLedger平台构建 遵循MCP服务器构建指南v1.0.0 真实世界测试和验证 ✅