JinDaGe - slunk-mcp MCP Details

article

README

🚀 Slunk - 适用于 macOS 的实时 Slack 搜索工具

Slunk 可实时监控 Slack，并通过与 Claude Desktop 集成的 MCP 服务器提供智能搜索功能。它能帮助用户更高效地在 Slack 海量消息中找到所需信息，提升工作沟通效率。

🚀 快速开始

前提条件

macOS 13.0 及以上版本
Xcode 15.0 及以上版本
安装 Slack 桌面应用程序

构建与运行

# 构建
cd slunk-swift
xcodebuild -project slunk-swift.xcodeproj -scheme slunk-swift -configuration Release build

# 运行图形用户界面（菜单栏应用程序）
open ~/Library/Developer/Xcode/DerivedData/slunk-swift-*/Build/Products/Release/slunk-swift.app

# 配置 Claude Desktop
# 添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
  "mcpServers": {
    "slunk-swift": {
      "command": "/path/to/slunk-swift.app/Contents/MacOS/slunk-swift",
      "args": ["--mcp"]
    }
  }
}

✨ 主要特性

🔍 实时监控 - 利用辅助功能 API 捕获 Slack 消息。
🧠 语义搜索 - 采用苹果的 NLEmbedding 进行概念匹配。
💾 本地存储 - 使用 SQLite 存储数据，自动去重并保留 2 个月的数据。
🤖 8 种 MCP 工具 - 支持自然语言搜索、分析和模式发现。
🔒 隐私至上 - 所有数据都存储在本地设备上。

📚 详细文档

MCP 工具

| 属性 | 详情 | |------|------| | searchConversations | 对所有消息进行自然语言搜索 | | search_messages | 按频道、用户或日期进行精确过滤 | | get_thread_context | 提取完整的线程对话 | | get_message_context | 解析短消息和表情符号 | | parse_natural_query | 从查询中提取意图 | | conversational_search | 支持多轮搜索会话 | | discover_patterns | 发现热门话题 | | suggest_related | 发现相关对话 |

架构

图形用户界面模式：通过菜单栏应用程序监控 Slack。
MCP 模式：作为 JSON - RPC 服务器与 Claude 集成。
数据库：使用带有 512 维嵌入的 SQLiteVec。
存储路径：~/Library/Application Support/Slunk/

🔧 技术细节

开发相关的详细技术说明请参考 CLAUDE.md。

📄 许可证

本项目采用 MIT 许可证。

slunk-mcp