使用说明
Slack MCP服务器
一个轻量级的模型上下文协议（MCP）服务器，提供对Slack对话的只读访问。此服务器使Cursor的AI助手能够直接从您的工作区检索和分析Slack线程对话。
它的作用
Slack MCP服务器公开了一个名为 read_thread 这允许Cursor执行以下操作：
- 阅读松弛线程：获取完整的线程对话，包括原始消息和所有回复
- 解析Slack URL：自动从Slack永久链接URL中提取频道和线程ID
- 设置对话格式：以可读格式返回带有时间戳和作者的线程内容
可用工具： read_thread
参数：
url（string，必填）：完整的Slack线程URL
退货：
- 完整的线程对话文本，包括所有回复，用时间戳和作者信息格式化
Slack URL格式示例：
https://alvys.slack.com/archives/C0982014L82/p1762872519417859
安装
步骤1：安装Rust工具链
如果您没有安装Rust，请按照操作系统的说明进行操作：
macOS或Linux
在终端中运行以下命令：
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
按照提示操作（按Enter键接受默认值）。安装后，重新启动终端或运行：
source $HOME/.cargo/env
验证安装：
rustc --version
cargo --version
视窗
- 从以下位置下载并运行Rust安装程序：https://rustup.rs/
- 按照安装向导进行操作（接受默认设置）
- 重新启动终端/PowerShell
- 验证安装：
rustc --version
cargo --version
备注：在Windows上，您可能需要安装 Visual Studio生成工具 如果在Rust安装过程中出现提示。
步骤2：构建服务器
克隆存储库并构建服务器：
# Clone the repository
git clone https://github.com/stulentsev/slack_mcp
cd slack_mcp
# Install the binary to Cargo's bin directory
cargo install --path .
二进制文件将安装到 ~/.cargo/bin/slack_mcp （macOS/Linux）或 %USERPROFILE%\.cargo\bin\slack_mcp.exe （Windows）。安装Rust时，此目录会自动添加到PATH中。
第3步：获取Slack代币
此集成使用共享的公司Slack机器人令牌（不是个人令牌）。要获取它：
- 打开你公司的 Keeper保管库
- 搜索“Slack-MCP服务器（只读）”
- 复制令牌（它应该以开头
xoxb-)
这是专门为此MCP集成配置的共享只读机器人令牌。不要创建自己的Slack应用程序——使用这个。
步骤4：创建配置文件
创建配置文件：
macOS/Linux：
# Create the config directory
mkdir -p ~/.config/slackmcp
# Create the config file
cat > ~/.config/slackmcp/config << EOF
SLACK_TOKEN=xoxb-your-token-from-keeper-vault
EOF
# Secure the file (restrict access to your user only)
chmod 600 ~/.config/slackmcp/config
窗户：
# Create the config directory
New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.config\slackmcp
# Create the config file
$token = "xoxb-your-token-from-keeper-vault"
"SLACK_TOKEN=$token" | Out-File -FilePath $env:USERPROFILE\.config\slackmcp\config -Encoding utf8 -NoNewline
重要：替换 xoxb-your-token-from-keeper-vault 使用您从Keeper复制的实际令牌。
配置路径遵循 XDG基本目录规范。您可以通过设置来覆盖它 $XDG_CONFIG_HOME.遗产之路 ~/.slackmcp.config 仍然支持作为回退。
步骤5：配置游标
- 打开的游标
- 打开MCP设置（通常在设置中找到→ 特性→ 模型上下文协议）
- 将以下配置添加到MCP服务器列表中：
{
"mcpServers": {
"slack": {
"command": "/Users/YOUR_USERNAME/.cargo/bin/slack_mcp"
}
}
}
备注:
- macOS/Linux：替换
YOUR_USERNAME使用您的实际用户名。你可以通过跑步找到它whoami在终端。这条路将是~/.cargo/bin/slack_mcp. - 视窗：使用Windows路径格式。，
C:\Users\YOUR_USERNAME\.cargo\bin\slack_mcp.exe
或者，如果 ~/.cargo/bin （或 %USERPROFILE%\.cargo\bin 在Windows上）在您的PATH中，您可以使用 slack_mcp 作为命令。
步骤6：重新启动游标
完全重新启动Cursor，使MCP服务器配置生效。
用法
安装和配置后，您可以在Cursor中使用Slack MCP服务器，要求它读取Slack线程。例如：
Can you read this Slack thread and summarize the key points?
https://alvys.slack.com/archives/C0982014L82/p1762872519417859
或者：
From this thread https://alvys.slack.com/archives/C0982014L82/p1762872519417859,
what was the final decision on the deployment schedule?
故障排除
“找不到令牌”错误
解决方案：确保您的配置文件存在并且包含正确的令牌。验证文件路径和权限：
ls -la ~/.config/slackmcp/config
cat ~/.config/slackmcp/config
“未找到频道”错误
可能的原因:
- Slack机器人尚未添加到频道中
- URL中的频道ID无效
解决方案：请您的团队负责人使用以下命令将Slack机器人添加到频道中 /invite @slack-bot-name
未找到二进制文件
解决方案：验证Cursor MCP配置中的二进制路径是否与放置文件的位置匹配：
macOS/Linux：
# Check if the binary exists and is executable
ls -la ~/.cargo/bin/slack_mcp
# Test running it directly
~/.cargo/bin/slack_mcp
窗户：
# Check if the binary exists
Test-Path $env:USERPROFILE\.cargo\bin\slack_mcp.exe
# Test running it directly
& $env:USERPROFILE\.cargo\bin\slack_mcp.exe
如果该路径上不存在二进制文件，请使用正确的路径更新Cursor MCP配置。
构建错误
解决方案：如果遇到构建错误：
-
确保您拥有最新的Rust工具链：
rustup update -
在Linux上，您可能需要其他系统依赖项：
# Ubuntu/Debian sudo apt-get install build-essential pkg-config libssl-dev # Fedora/RHEL sudo dnf install gcc pkg-config openssl-devel -
在macOS上，确保你有Xcode命令行工具：
xcode-select --install
MCP服务器未出现在光标中
解决方案:
- 验证您的游标MCP配置JSON是否有效
- 确保已完全重新启动Cursor（退出并重新打开）
- 检查Cursor的MCP服务器日志中的错误消息
安全
重要:
- 你的
~/.config/slackmcp/config文件包含共享的公司凭据。确保其安全，切勿在组织外部共享。 - 文件权限(
chmod 600)确保只有你能阅读它。 - 切勿将此文件提交到版本控制。
运作原理
服务器实现了模型上下文协议（MCP）标准，通过stdin/stdout上的JSON-RPC与Cursor通信。当Cursor需要读取Slack线程时，它会向服务器发送一个请求，该请求：
- 解析Slack URL以提取通道ID和线程时间戳
- 使用您的机器人令牌通过Slack API进行身份验证
- 获取线程对话
- 格式化对话文本并将其返回到Cursor
服务器是只读的，无法在Slack工作区上发布消息、修改内容或执行任何写入操作。
