slack-patron-mcp

slack-patron (https://github.com/tsg-ut/slack-patron) のSlackメッセージ履歴APIをClaudeから利用するためのリモートMCPサーバー。

概要

• トランスポート: Streamable HTTP (stateless)
• 認証: Bearer token (MCP_SERVER_AUTH_TOKEN)
• 上流API: SLACK_PATRON_BASE_URL 環境変数で設定

利用可能なツール

ツール名	説明
list_channels	ワークスペースの全チャンネル一覧を取得
get_channel_messages	チャンネルのメッセージ履歴を取得 (時刻範囲・ページネーション対応)
get_thread_replies	スレッドの返信一覧を取得

get_channel_messages パラメータ

パラメータ	型	必須	説明
channel	string	✓	チャンネルID (C01234567) またはチャンネル名 (general, #general)
limit	number	-	取得件数 (1-200, デフォルト50)
oldest	string	-	開始タイムスタンプ (例: 1700000000.000000)
latest	string	-	終了タイムスタンプ
cursor	string	-	ページネーションカーソル (前回レスポンスから取得)

get_thread_replies パラメータ

パラメータ	型	必須	説明
channel	string	✓	チャンネルID
thread_ts	string	✓	親メッセージのタイムスタンプ
limit	number	-	取得件数 (1-200, デフォルト50)
cursor	string	-	ページネーションカーソル

セットアップ

必要な環境変数

変数名	説明
MCP_SERVER_AUTH_TOKEN	Claudeがこのサーバーに接続する際のBearerトークン
SLACK_PATRON_API_TOKEN	slack-patronの上流APIへのBearerトークン
SLACK_PATRON_BASE_URL	slack-patron上流APIのベースURL (末尾スラッシュなし)
PORT	サーバーポート (デフォルト: 29112)

ローカル開発

# 依存関係インストール
npm install

# 環境変数設定
cp .env.example .env
# .env を編集して実際の値を設定

# 開発サーバー起動 (ホットリロード付き)
npm run dev

# ビルド
npm run build

# テスト
npm test

Nginx設定

# 設定ファイルをコピー (nginx/ ディレクトリは .gitignore 対象のため各自作成)
sudo cp nginx/your-vhost-config /etc/nginx/sites-available/

# シンボリックリンク作成
sudo ln -s /etc/nginx/sites-available/your-vhost-config \
           /etc/nginx/sites-enabled/your-vhost-config

# 設定確認と再読み込み
sudo nginx -t && sudo systemctl reload nginx

Claude カスタムコネクタ登録方法

Claude.ai または Claude Code で以下のように設定する:

1. MCP サーバーの設定を開く
2. 「カスタムコネクタを追加」を選択
3. 以下を入力:
   • URL: https://your-server.example.com/mcp
   • 認証タイプ: Bearer Token
   • トークン: .env の MCP_SERVER_AUTH_TOKEN の値

Claude Code の場合 (~/.claude/settings.json):

{
  "mcpServers": {
    "slack-patron": {
      "type": "http",
      "url": "https://your-server.example.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_SERVER_AUTH_TOKEN"
      }
    }
  }
}

動作確認 curl コマンド

MCP の Streamable HTTP トランスポートでは Accept: application/json, text/event-stream ヘッダーが必須です (Claude クライアントは自動付与するが、curl では明示指定が必要)。

export TOKEN="your-mcp-server-auth-token"
export BASE="https://your-server.example.com"
# MCP リクエスト共通ヘッダー
MCP_HEADERS=('-H' 'Content-Type: application/json' '-H' 'Accept: application/json, text/event-stream')

# ヘルスチェック (認証不要)
curl "${BASE}/health"

# 認証失敗の確認
curl -X POST "${BASE}/mcp" \
  "${MCP_HEADERS[@]}" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# → 401 Unauthorized

# ツール一覧
curl -X POST "${BASE}/mcp" \
  -H "Authorization: Bearer ${TOKEN}" \
  "${MCP_HEADERS[@]}" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# チャンネル一覧取得
curl -X POST "${BASE}/mcp" \
  -H "Authorization: Bearer ${TOKEN}" \
  "${MCP_HEADERS[@]}" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_channels","arguments":{}}}'

# メッセージ取得 (チャンネル名指定)
curl -X POST "${BASE}/mcp" \
  -H "Authorization: Bearer ${TOKEN}" \
  "${MCP_HEADERS[@]}" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_channel_messages","arguments":{"channel":"general","limit":10}}}'

# スレッド返信取得
curl -X POST "${BASE}/mcp" \
  -H "Authorization: Bearer ${TOKEN}" \
  "${MCP_HEADERS[@]}" \
  -d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"get_thread_replies","arguments":{"channel":"C01234567","thread_ts":"1700000000.123456"}}}'

セキュリティ

• 全シークレットは環境変数経由で管理 (コードにハードコードしない)
• MCP認証はBearerトークン + タイミング安全比較 (crypto.timingSafeEqual)
• ログにトークンやメッセージ内容を出力しない
• 上流APIエラー時はHTTPステータスコードのみ通知 (スタックトレース非公開)
• slack-patronへのリクエストは常に limit を指定し大量取得を防止
• 書き込み系操作は一切実装しない (読み取り専用)