使用说明

项目简介

Slack工具 MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在使AI助手能够与Slack工作空间进行交互。它提供了一系列工具，允许AI助手执行诸如搜索Slack消息、更新用户状态、创建和管理提醒等操作，从而扩展了AI助手在工作环境中的应用能力。

主要功能点

Slack 数据访问能力: 提供对Slack消息的搜索功能，可以根据关键词和消息数量检索Slack工作空间内的信息。
Slack 状态管理: 允许AI助手更新用户的Slack状态，包括设置状态文本、表情符号和过期时间。
Slack 提醒管理: 支持创建和管理Slack提醒，包括设置提醒文本和时间。
系统时间获取: 提供获取当前系统日期和时间的功能，支持本地时区和UTC时间。
Markdown 格式化输出: 所有工具的响应都以Markdown格式返回，方便AI助手进行内容展示和理解。

安装步骤

克隆仓库

git clone https://github.com/rygwdn/slack-tools
cd slack-tools

安装依赖
```
npm install
```
全局链接
```
npm link
```
安装完成后，'slack-tools' 命令即可在终端中使用。

服务器配置

MCP客户端需要配置以下JSON格式信息以连接到 Slack工具 MCP 服务器：

{
  "serverName": "slack-tools-mcp-server",
  "command": "slack-tools",
  "args": ["mcp", "-w", "<your_slack_workspace_name>"]
  // "command": "slack-tools",  // 启动服务器的命令，通常为安装后的可执行文件名
  // "args": ["mcp", "-w", "<your_slack_workspace_name>"] // 传递给启动命令的参数，
                                                  // "mcp" 子命令启动 MCP 服务器，
                                                  // "-w <your_slack_workspace_name>" 指定要连接的Slack工作区名称或URL，请替换为您的实际工作区名称
}

请注意: '<your_slack_workspace_name>' 需要替换为您要连接的实际Slack工作区的名称或URL。您可以使用 'slack-tools print' 命令查看您已配置的工作区名称。

基本使用方法

启动 MCP 服务器

在终端中，使用以下命令启动 Slack工具 MCP 服务器，并指定您的 Slack 工作区：

slack-tools mcp -w <your_slack_workspace_name>

或者，如果您想使用最近使用的工作区，可以使用：

slack-tools mcp -l

配置 MCP 客户端

在您的 MCP 客户端（例如 Claude 等支持MCP协议的AI助手）中，配置上面提供的服务器配置信息。客户端将使用 JSON-RPC 协议通过标准输入/输出 (stdio) 与 Slack工具 MCP 服务器进行通信。
使用工具

一旦客户端成功连接到服务器，您就可以通过客户端调用服务器提供的各种工具，例如 'slack_search'、'slack_set_status' 等，来实现与Slack工作空间的交互。具体的工具及其参数请参考仓库的 README 文档中 “MCP Command” 部分的描述。

重要提示:

运行 'slack-tools mcp' 命令前，请确保您已经使用 'slack-tools print' 命令成功获取了 Slack 工作区的令牌和 Cookie。
首次运行或配置变更后，可能需要重启 MCP 客户端以确保连接配置生效。

关键词