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从源头构建
- 克隆存储库：
git clone https://github.com/SH11235/slack-conversation-logger.git
cd slack-conversation-logger- 本地安装：
cargo install --path .或者在不安装的情况下构建：
cargo build --release
# Binary will be at ./target/release/slack-conversation-logger配置
Claude代码的快速设置
- 如果要使用安装脚本，请克隆存储库：
git clone https://github.com/SH11235/slack-conversation-logger.git
cd slack-conversation-logger
./setup-slack-env.sh- 编辑
~/.claude/slack-config.json使用您的Slack凭据：
{
"bot_token": "xoxb-your-slack-bot-token",
"channel_id": "C1234567890",
"thread_name": "Conversation Log" // Optional, defaults to "Conversation Log"
}- 加载环境变量（如果使用配置文件）：
source ./load-slack-env.sh- 将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
- 首选https://api.slack.com/apps并创建新应用程序
- 选择“从头开始”并为您的应用程序命名
- 在“OAuth和权限”下，添加所需的机器人令牌范围：
- chat:write - chat:write.public - channels:read
- 将应用程序安装到您的工作区
- 复制Bot用户OAuth令牌（以开头
xoxb-) - 邀请机器人到您的目标频道：
/invite @your-bot-name - 获取通道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作用域
- 添加作用域后，将应用程序重新安装到工作区
发展
要修改记录器：
- 在中编辑源文件
src/
- 关键文件：
- main.rs：入口点和配置 - slack.rs：Slack API客户端实现 - logger.rs：MCP工具实施
- 本地测试：
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工作区中维护重要项目决策和进度的审计跟踪。