Slack对话记录器
将对话记录到Slack线程的MCP(模型上下文协议)服务器。这是一个Rust实现,允许AI助手将重要的交互、决策或上下文记录到指定的Slack频道。
特性
- 使用基于角色的格式将消息记录到Slack线程
- 支持带有颜色编码的人工、助理和系统消息类型
- 自动为每个工作目录创建一个新线程
- 线程安全消息发布
- 每条消息的可选上下文元数据
- 通过环境变量或命令行参数进行配置
先决条件
- Rust(最新稳定版本)
- 配置了机器人应用程序的Slack工作区
- 所需的Slack机器人权限:
chat:writechat:write.public(如果发布到公共渠道)channels:read(验证信道接入)
安装
使用货物(推荐)```bash
cargo install --git https://github.com/SH11235/slack-conversation-logger.git
### 从源头构建
1. 克隆存储库:```bash
git clone https://github.com/SH11235/slack-conversation-logger.git
cd slack-conversation-logger
- 本地安装:```bash
cargo install --path .
或者在不安装的情况下构建:```bash
cargo build --release
# Binary will be at ./target/release/slack-conversation-logger
配置
Claude代码的快速设置
- 如果要使用安装脚本,请克隆存储库:```bash
git clone https://github.com/SH11235/slack-conversation-logger.git
cd slack-conversation-logger
./setup-slack-env.sh
1. 编辑 `~/.claude/slack-config.json` 使用您的Slack凭据:```json
{
"bot_token": "xoxb-your-slack-bot-token",
"channel_id": "C1234567890",
"thread_name": "Conversation Log" // Optional, defaults to "Conversation Log"
}
- 加载环境变量(如果使用配置文件):```bash
source ./load-slack-env.sh
1. 将MCP服务器添加到Claude代码中:```bash
# 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在底部)
用法
运行服务器
对于环境变量:```bash
export SLACK_TOKEN="xoxb-your-token"
export LOG_CHANNEL_ID="C1234567890"
export LOG_THREAD_NAME="My Conversation Log" # Optional
cargo run
或者使用命令行参数:```bash
cargo run -- --slack-token "xoxb-your-token" --channel-id "C1234567890"
使用内置二进制文件:```bash
./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 上:```json
{
"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. 本地测试:```bash
cargo test
cargo run
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
CLAUDE.md配置
为了在与Claude一起使用此MCP服务器时鼓励正确的日志记录实践,请将以下内容添加到您的 CLAUDE.md 文件:```markdown
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工作区中维护重要项目决策和进度的审计跟踪。
