Slack MCP (Karbassi)

松弛MCP

你的整个Slack工作空间——可供任何AI使用。

A. 模型上下文协议 赋予LLM完全访问权限的服务器 Slack.

消息、频道、文件、画布、列表、搜索、反应——所有这些。

220工具 · 36个API系列 · 每个Slack功能

______________________________________________________________________

快速开始

1.创建Slack应用程序

1. 首选 api.slack.com/apps > 创建新应用程序 > 从清单
2. 粘贴以下内容 manifest.json
3. 安装到您的工作区
4. 复制 用户OAuth令牌 (xoxp-...)从 OAuth和权限

2.添加到您的AI客户端

Claude Code

claude mcp add slack -- uvx --from git+https://github.com/karbassi/slack-mcp.git slack-mcp

然后设置 SLACK_XOXP_TOKEN 在您的shell环境中。

Claude Desktop

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "slack": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/karbassi/slack-mcp.git", "slack-mcp"],
      "env": {
        "SLACK_XOXP_TOKEN": "xoxp-..."
      }
    }
  }
}

Cursor

添加 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "slack": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/karbassi/slack-mcp.git", "slack-mcp"],
      "env": {
        "SLACK_XOXP_TOKEN": "xoxp-..."
      }
    }
  }
}

Windsurf

添加 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "slack": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/karbassi/slack-mcp.git", "slack-mcp"],
      "env": {
        "SLACK_XOXP_TOKEN": "xoxp-..."
      }
    }
  }
}

VS Code / GitHub Copilot

添加到您的VS代码 settings.json:

{
  "mcp": {
    "servers": {
      "slack": {
        "command": "uvx",
        "args": ["--from", "git+https://github.com/karbassi/slack-mcp.git", "slack-mcp"],
        "env": {
          "SLACK_XOXP_TOKEN": "xoxp-..."
        }
      }
    }
  }
}

Local clone

{
  "mcpServers": {
    "slack": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/slack-mcp", "slack-mcp"]
    }
  }
}

它能做什么？

*“从今天开始，跟我聊聊#engineering”* *“回复Sarah的帖子，说我们将于周一发货”* *“搜索有关Q3路线图的任何信息”* *“创建一个名为#project atlas的频道，并邀请设计团队”*

加 resolve_names （批量ID→名称解析）和 cache_clear （按需破坏响应缓存）实用工具。

API官方之外

39个未记录和遗留的端点——与Slack自己的应用程序使用的内部API相同。需要会话令牌(xoxc+xoxd).

Session endpoints — workspace state the official API doesn't expose

Legacy endpoints — functionality missing from the official API

\[！警告\] 未记录的端点可能会中断，恕不另行通知。他们使用会话令牌(xoxc+xoxd)这些Cookie过期，必须从浏览器Cookie中重新抓取。

认证

\[！提示\] 这 xoxp 令牌涵盖所有Slack Web API工具。实用工具，如 resolve_names 和 cache_clear 无需额外身份验证即可工作。对于未记录的端点（未读计数、工作区启动、文件编辑），您还需要 xoxc+xoxd --登录slack.com时从浏览器Cookie中获取它们。

缓存

响应会自动缓存以减少API调用：

• 稳定数据 （用户、团队、机器人、表情符号）-1小时TTL
• 动态数据 （频道列表、成员、书签）-5分钟TTL
• 旧线程 (conversations_replies ts>1小时）-1小时TTL
• 有限的历史 (conversations_history 使用旧日期范围）--1小时TTL
• 解析名称 （用户/机器人→ 1 小时，频道→ 5 分钟）

缓存存储在平台本机位置(~/Library/Caches/slack-mcp 在macOS上， ~/.cache/slack-mcp 在Linux上）。集 XDG_CACHE_HOME 以覆盖。

使用 cache_clear 当您需要新数据时，该工具会破坏缓存。

名称解析

所有工具响应都会自动解析用户、频道、DM和机器人ID，以通过 resolved_names 字段——不需要额外的工具调用。解析的名称是磁盘缓存的，以避免重复的API查找。

响应压实

15个高容量工具自动从Slack API响应中去除膨胀-块（重复文本）、附件（链接展开）、缩略图（每个文件22个）和元数据噪音。实测减少量：

默认情况下，“压缩”处于启用状态。通过 detailed=True 以获得Slack API的完整响应。

发展

git clone https://github.com/karbassi/slack-mcp.git
cd slack-mcp
uv sync
mise run check                       # test + lint + security scan
mise run test:integration            # requires tokens in .env

\[！注意\] 约68个集成测试被跳过，因为它们需要bot令牌(xoxb)Slack Connect、交互式触发器（例如。 views.open)，或具有破坏性（例如。 auth.revoke).添加机器人令牌支持是未来的目标。

许可证

麻省理工学院