channelchat

channelchat

channelchat 让 MCP 客户端能够在 Slack 工作区中正常使用：列出频道、发布消息、继续线程、 添加表情回应，以及查看历史记录或成员列表。 它通过 Slack Web API 实现完整的 server-slack 工具集——全部八个 工具。

需要设置两个环境变量，与原始 服务完全相同：SLACK_BOT_TOKEN（机器人用户 OAuth 令牌，以 Bearer 令牌形式发送）和 SLACK_TEAM_ID（工作区 ID，传递给 接受该参数的方法）。如果缺少其中任意一个，每次调用都会返回指出缺失变量的 错误，而不是在握手时失败。

即使调用失败，Slack 的 Web API 也会返回 HTTP 200，并在响应正文中包含 ok: false；channelchat 会将正文中的 error 字符串作为 工具错误返回，因此调用方会原样收到 channel_not_found 等错误。

安装

npx @reneturcios/channelchat slack_list_channels
docker run -i -e SLACK_BOT_TOKEN -e SLACK_TEAM_ID ghcr.io/cloudcorprecords/channelchat

CLI

channelchat slack_list_channels --limit 20
channelchat slack_post_message --channel-id C0123 --text "deploy finished"
channelchat slack_reply_to_thread --channel-id C0123 --thread-ts 1700000000.000100 --text "looking into it"
channelchat slack_add_reaction --channel-id C0123 --timestamp 1700000000.000100 --reaction thumbsup
channelchat slack_get_user_profile --user-id U0123
channelchat --version

退出代码：0 表示成功，1 表示 API 错误，2 表示用法错误。

MCP 服务

npx -y @reneturcios/channelchat mcp

{
  "mcpServers": {
    "channelchat": {
      "command": "npx",
      "args": ["-y", "@reneturcios/channelchat", "mcp"],
      "env": { "SLACK_BOT_TOKEN": "xoxb-...", "SLACK_TEAM_ID": "T0123" }
    }
  }
}

工具

工具	必需	可选
slack_list_channels	—	types、exclude_archived、limit
slack_post_message	channel_id、text	—
slack_reply_to_thread	channel_id、thread_ts、text	—
slack_add_reaction	channel_id、timestamp、reaction	—
slack_get_channel_history	channel_id	limit
slack_get_thread_replies	channel_id、thread_ts	—
slack_get_users	—	cursor、limit
slack_get_user_profile	user_id	—

工具参数使用文档所列的、面向调用方的名称（channel_id、thread_ts、reaction、user_id）；核心模块会在构建每个请求时，将它们映射为 Web API 的参数名称（channel、ts、 name、user）。

开发

npm install
npm run build
npm test
npm run dev

测试完全基于虚假的 fetch 测试夹具运行，包括 Slack 返回 HTTP 200 但 ok: false 的错误格式；不会使用网络。

许可证

MIT——详见 LICENSE。