Slack Conversation Logger

Slack对话记录器

将对话记录到Slack线程的MCP（模型上下文协议）服务器。这是一个Rust实现，允许AI助手将重要的交互、决策或上下文记录到指定的Slack频道。

特性

• 使用基于角色的格式将消息记录到Slack线程
• 支持带有颜色编码的人工、助理和系统消息类型
• 自动为每个工作目录创建一个新线程
• 线程安全消息发布
• 每条消息的可选上下文元数据
• 通过环境变量或命令行参数进行配置

先决条件

• Rust（最新稳定版本）
• 配置了机器人应用程序的Slack工作区
• 所需的Slack机器人权限：

- chat:write - chat:write.public （如果发布到公共渠道） - channels:read （验证信道接入）

安装

使用货物（推荐）

cargo install --git https://github.com/SH11235/slack-conversation-logger.git

从源头构建

1. 克隆存储库：

git clone https://github.com/SH11235/slack-conversation-logger.git
cd slack-conversation-logger

1. 本地安装：

cargo install --path .

或者在不安装的情况下构建：

cargo build --release
# Binary will be at ./target/release/slack-conversation-logger

配置

Claude代码的快速设置

1. 如果要使用安装脚本，请克隆存储库：

   git clone https://github.com/SH11235/slack-conversation-logger.git
   cd slack-conversation-logger
   ./setup-slack-env.sh

1. 编辑 ~/.claude/slack-config.json 使用您的Slack凭据：

   {
     "bot_token": "xoxb-your-slack-bot-token",
     "channel_id": "C1234567890",
     "thread_name": "Conversation Log"  // Optional, defaults to "Conversation Log"
   }

1. 加载环境变量（如果使用配置文件）：

   source ./load-slack-env.sh

1. 将MCP服务器添加到Claude代码中：

   # For global use (available in all projects):
   claude mcp add -s user slack-conversation-logger slack-conversation-logger \
     -e SLACK_TOKEN="$SLACK_TOKEN" \
     -- --channel-id "$LOG_CHANNEL_ID" --thread-name "$LOG_THREAD_NAME"

   # Or manually specify values:
   claude mcp add -s user slack-conversation-logger slack-conversation-logger \
     -e SLACK_TOKEN="xoxb-your-actual-slack-bot-token" \
     -- --channel-id "C1234567890" --thread-name "Conversation Log"

   # For local project use (default):
   claude mcp add slack-conversation-logger slack-conversation-logger \
     -e SLACK_TOKEN="$SLACK_TOKEN" \
     -- --channel-id "$LOG_CHANNEL_ID" --thread-name "$LOG_THREAD_NAME"

手动配置

服务器需要通过环境变量或命令行参数进行以下配置：

• SLACK_TOKEN：您的Slack机器人令牌（必填）
• LOG_CHANNEL_ID：要登录的通道ID（必需）
• LOG_THREAD_NAME：线程名称前缀（可选，默认：“对话日志”）

设置Slack Bot

1. 首选https://api.slack.com/apps并创建新应用程序
2. 选择“从头开始”并为您的应用程序命名
3. 在“OAuth和权限”下，添加所需的机器人令牌范围：

- chat:write - chat:write.public - channels:read

1. 将应用程序安装到您的工作区
2. 复制Bot用户OAuth令牌（以开头 xoxb-)
3. 邀请机器人到您的目标频道： /invite @your-bot-name
4. 获取通道ID（右键单击通道→ 查看频道详细信息→ ID在底部）

用法

运行服务器

对于环境变量：

export SLACK_TOKEN="xoxb-your-token"
export LOG_CHANNEL_ID="C1234567890"
export LOG_THREAD_NAME="My Conversation Log"  # Optional
cargo run

或者使用命令行参数：

cargo run -- --slack-token "xoxb-your-token" --channel-id "C1234567890"

使用内置二进制文件：

./target/release/slack-conversation-logger --slack-token "xoxb-your-token" --channel-id "C1234567890"

MCP集成

添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在 macOS 上：

{
  "mcpServers": {
    "slack-logger": {
      "command": "/path/to/slack-conversation-logger",
      "env": {
        "SLACK_TOKEN": "xoxb-your-token",
        "LOG_CHANNEL_ID": "C1234567890",
        "LOG_THREAD_NAME": "Claude Conversations"
      }
    }
  }
}

可用工具

服务器提供了一个工具：

log_conversation

将消息记录到配置的Slack频道。

参数：

• role （必填）：消息发送者角色-“人”、“助理”或“系统”
• message （必填）：要记录的消息内容
• context （可选）：附加上下文或元数据

Claude中的示例用法：

I'll log this decision to Slack for future reference.

log_conversation

{
  "role": "assistant",
  "message": "Implemented Slack conversation logger based on Discord version",
  "context": "Created new Rust MCP server with slack-morphism client"
}

消息格式

邮件以Slack附件的形式发布，其中包含：

• 颜色编码：蓝色（人）、绿色（助手）、灰色（系统）
• 显示角色的作者姓名
• UTC时间戳
• 可选上下文字段
• 以当前工作目录命名的线程中的所有消息

故障排除

“无效身份验证”错误

• 验证您的机器人令牌以开头 xoxb-
• 确保令牌未被撤销
• 检查是否添加了所有必需的范围

“channel_not_found”错误

• 验证通道ID是否正确（应以C开头）
• 确保机器人已被邀请到该频道
• 对于私人渠道，机器人需要成为会员

“missing_scope”错误

• 在Slack应用程序设置中添加所需的OAuth作用域
• 添加作用域后，将应用程序重新安装到工作区

发展

要修改记录器：

1. 在中编辑源文件 src/

1. 关键文件：

- main.rs：入口点和配置 - slack.rs：Slack API客户端实现 - logger.rs：MCP工具实施

1. 本地测试：

cargo test
cargo run

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

CLAUDE.md配置

为了在与Claude一起使用此MCP服务器时鼓励正确的日志记录实践，请将以下内容添加到您的 CLAUDE.md 文件：

# Slack Conversation Logger Rules

## Important Message Logging Rules

Please use slack-conversation-logger MCP to log messages in the following cases:

### 1. User Messages (human)
- Task start/change/completion instructions
- Important decisions or confirmations  
- Error reports or issue identification
- Feature requests and requirements

### 2. Assistant Messages (assistant)
- Task completion reports
- Important suggestions or solutions
- Error resolution methods
- Summary of significant changes made
- Key implementation decisions

### 3. System Messages (system)
- Critical errors or warnings
- Important environment changes
- Security-related notifications
- Build or test failures

## Logging Format

mcp_slack-conversion-logger\_\_log_conversation( message:“实际消息内容”， 角色：“人”|“助手”|“系统”， context：“简要上下文描述” )

## When to Log
- Beginning of significant tasks
- Completion of major milestones
- Important architecture or design decisions
- Bug discoveries and their resolutions
- Any changes that affect the project's functionality

## Cases Not Requiring Logs
- Simple acknowledgments
- Intermediate progress reports  
- Temporary debug outputs
- Minor code formatting changes
- Routine file reads or searches

此配置有助于在Slack工作区中维护重要项目决策和进度的审计跟踪。