yt-slack-mcp

用于 Slack 的 MCP 服务器 — 读取永久链接、线程和频道历史；回复线程；添加表情反应。

实现了 Model Context Protocol 规范：它通过 stdio 传输运行，使用 JSON-RPC 2.0 通信，在 initialize 时协商协议版本，声明 tools 能力，并用 JSON Schema 描述每个工具。协议版本协商由 @modelcontextprotocol/sdk 的 Server 类处理，该类默认使用最新支持的版本。

工具

读取工具使用私有的 Slack 浏览器会话 API（通过 xoxc / xoxd 令牌），因此可以获取私有文件内容 — PDF 会被下载并提取文本（最多 50 页 / 100k 字符），图片则以内联方式返回。

Related MCP server: Slack MCP Server

设置

1. 获取浏览器会话令牌

• xoxc：Slack 网页版 localStorage 令牌（来自你已登录的浏览器会话）。

• xoxd：名为 d 的 Slack Cookie。

当 Slack 轮换/失效会话时，这些令牌可能需要刷新。

2. 放置密钥

将每个令牌保存为单行文件：

~/.config/opencode/secrets/slack-xoxc.txt
~/.config/opencode/secrets/slack-xoxd.txt

或者通过配置文件或环境变量覆盖路径。

3. （可选）配置允许写入的频道和路径

所有配置都可以放在 JSON 配置文件中，路径为 ~/.config/yt-slack-mcp/config.json（可通过 SLACK_MCP_CONFIG 覆盖）：

{
  "secretsDir": "~/.config/opencode/secrets",
  "xoxcPath": "~/.config/opencode/secrets/slack-xoxc.txt",
  "xoxdPath": "~/.config/opencode/secrets/slack-xoxd.txt",
  "allowedWriteChannels": ["C0123456789", "C0987654321"],
  "userAgent": "Mozilla/5.0"
}

默认情况下，写入工具（slack_reply_to_thread、slack_add_reaction） 是锁定的 — 没有任何频道可写。每个字段都是可选的；如果 文件缺失，则仅表示使用默认值。环境变量始终覆盖配置文件。

配置

配置解析顺序：内置默认值 → 配置文件 → 环境变量。

MCP 主机配置

opencode

{
  "mcp": {
    "slack": {
      "type": "local",
      "command": ["npx", "yt-slack-mcp"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["yt-slack-mcp"]
    }
  }
}

许可证

MIT