MCP Relay Server

🚀 MCP 中継サーバ

この MCP サーバは、Claude が Discord チャンネルにメッセージとプロンプトを送信し、返信を受け取ることを可能にします。

🚀 クイックスタート

✨ 主な機能

• Claude が Discord チャンネルにメッセージとプロンプトを送信できる。
• Discord チャンネルからの返信を受け取ることができる。

📦 インストール

1. Discord アプリケーションとボットの作成

1. Discord 開発者ポータルにアクセスします。
2. 「新しいアプリケーション」をクリックし、名前を付けます。
3. 左側のサイドバーの「Bot」セクションに移動します。
4. ボットのトークンセクションで、「トークンをリセット」をクリックし、新しいトークンをコピーします。
   • このトークンは必ず安全に保管してください！公開しないでください。
5. 「Privileged Gateway Intents」（特権ゲートウェイインテント）で以下を有効にします。
   • メッセージコンテンツインテント
   • サーバーメンバーインテント
   • オンラインインテント

2. ボットをサーバーに招待する

1. 左側のサイドバーの「OAuth2」セクションに移動します。
2. 「URL 生成ツール」を選択します。
3. 「スコープ」で以下を選択します。
   • bot
   • applications.commands
4. 「Bot Permissions」（ボットの権限）で以下を選択します。
   • メッセージを送信する
   • リンクを埋め込む
   • メッセージ履歴を読む
5. 生成された URL をコピーし、ブラウザで開きます。
6. サーバーを選択し、ボットを承認します。

3. チャンネル ID を取得する

1. Discord で開発者モードを有効にします。
   • ユーザー設定 > アプリ設定 > 高度な設定に移動します。
   • 「開発者モード」を有効にします。
2. 使用するチャンネルを右クリックします。
3. 「チャンネル ID をコピー」をクリックします。

4. MCP 設定の構成

サーバーは、MCP 設定ファイルで構成する必要があります。設定ファイルに以下の内容を追加します。

{
    "mcpServers": {
        "discord-relay": {
            "command": "node",
            "args": [
                "/ABSOLUTE/PATH/TO/MCP Relay/build/index.js"
            ],
            "env": {
                "DISCORD_TOKEN": "your_bot_token_here",
                "DISCORD_CHANNEL_ID": "your_channel_id_here"
            }
        }
    }
}

以下を置き換えます。

• /ABSOLUTE/PATH/TO/MCP Relay を実際の MCP 中継プロジェクトのパスに置き換えます。
• your_bot_token_here を自分の Discord ボットトークンに置き換えます。
• your_channel_id_here を選択した Discord チャンネル ID に置き換えます。

注意：設定では絶対パスを使用するようにしてください。

💻 使用例

基本的な使用法

サーバーは send-message というツールを提供しており、以下のパラメータを受け取ります。

{
  type: 'prompt' | 'notification',  // メッセージタイプ
  title: string,                    // メッセージのタイトル
  content: string,                  // メッセージの内容
  actions?: Array<{                 // オプションのアクションボタン
    label: string,                  // ボタンのラベル
    value: string                   // クリック後に返される値
  }>,
  timeout?: number                  // オプションのタイムアウト時間（ミリ秒）
}

高度な使用法

通知

単純なメッセージで、返信を必要としません。

{
  "type": "notification",
  "title": "こんにちは",
  "content": "これは通知です"
}

プロンプト

返信を待つメッセージです。

{
  "type": "prompt",
  "title": "質問",
  "content": "続けますか？",
  "actions": [
    { "label": "はい", "value": "yes" },
    { "label": "いいえ", "value": "no" }
  ],
  "timeout": 60000 // 例：60 秒のタイムアウト
}

📚 ドキュメント

注意事項

• メッセージ内容は最大 32,768 バイト までサポートされています。
• サポートされるファイルタイプには、PDF、DOCX、PPTX、ZIP、PNG、JPG などが含まれます。