yt-slack-mcp

Slack 用の MCP サーバー — パーマリンク、スレッド、チャンネル履歴の読み取り、スレッドへの返信、リアクションの追加が可能です。

Model Context Protocol 仕様を実装しています。stdio トランスポート上で動作し、JSON-RPC 2.0 で通信し、initialize でプロトコルバージョンをネゴシエーションし、tools 機能をアドバタイズし、各ツールを JSON Schema で記述します。プロトコルバージョンのネゴシエーションは @modelcontextprotocol/sdk の Server クラスが処理し、デフォルトで最新のサポートバージョンを使用します。

ツール

読み取りツールはプライベートな Slack ブラウザセッション API（xoxc / xoxd トークン経由）を使用するため、プライベートファイルの内容も取得できます — PDF はダウンロードしてテキスト抽出され（最大 50 ページ / 100k 文字）、画像はインラインで返されます。

Related MCP server: Slack MCP Server

セットアップ

1. ブラウザセッショントークンを取得する

• xoxc: Slack Web の localStorage トークン（ログイン済みのブラウザセッションから取得）。

• xoxd: d という名前の Slack クッキー。

Slack がセッションをローテーションまたは無効化した場合は、これらの更新が必要になる場合があります。

2. シークレットを配置する

各トークンを 1 行のファイルとして保存します:

~/.config/opencode/secrets/slack-xoxc.txt
~/.config/opencode/secrets/slack-xoxd.txt

または、設定ファイルや環境変数でパスを上書きします。

3. （任意）書き込み可能なチャンネルとパスを設定する

すべての設定は ~/.config/yt-slack-mcp/config.json の JSON 設定ファイルに記述できます（SLACK_MCP_CONFIG で上書き可能）:

{
  "secretsDir": "~/.config/opencode/secrets",
  "xoxcPath": "~/.config/opencode/secrets/slack-xoxc.txt",
  "xoxdPath": "~/.config/opencode/secrets/slack-xoxd.txt",
  "allowedWriteChannels": ["C0123456789", "C0987654321"],
  "userAgent": "Mozilla/5.0"
}

デフォルトでは、書き込みツール（slack_reply_to_thread、slack_add_reaction）はロックダウンされています — 書き込み可能なチャンネルはありません。すべてのフィールドは任意です。ファイルがない場合はデフォルト値が使用されます。環境変数は常に設定ファイルより優先されます。

設定

設定の解決順序: 組み込みデフォルト → 設定ファイル → 環境変数。

MCP ホスト設定

opencode

{
  "mcp": {
    "slack": {
      "type": "local",
      "command": ["npx", "yt-slack-mcp"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["yt-slack-mcp"]
    }
  }
}

ライセンス

MIT