MCP Discord Raw

🚀 Discord 原始 API MCP サーバー

この MCP サーバーは、柔軟なツールを通じて、Discord の生の API へのアクセスを提供します。REST API 呼び出しと Slash コマンド構文をサポートしています。

🚀 クイックスタート

このセクションでは、Discord 原始 API MCP サーバーの基本的な使い方を紹介します。

📦 インストール

Smithery を通じたインストール

Smithery を通じて、Claude Desktop 用の Discord 原始 API を自動的にインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @hanweg/mcp-discord-raw --client claude

手動インストール

1. Discord ボットを設定します。
   • Discord 開発者コンソール で新しいアプリケーションを作成します。
   • アプリケーションにボットユーザーを作成し、そのトークンを取得します。
2. 依存関係をインストールし、プロジェクト構造を設定します。

   git clone https://github.com/yourusername/mcp-discord-raw.git
   cd mcp-discord-raw
   npm install
   

3. Discord API の環境変数を設定します。
   • .env ファイルを作成し、以下の内容を追加します（YOUR_DISCORD_TOKEN を自分のトークンに置き換えてください）。

     DISCORD_TOKEN=your_discord_token_here
     

4. サーバーを起動します。

   npm start
   

📚 ドキュメント

設定

config.json ファイルに以下の設定を追加することで、Discord 原始 API のサポートを有効にできます。

{
  "apiEndpoints": {
    "discord": {
      "url": "https://discord.com/api/v9"
    }
  },
  "botConfig": {
    "token": "your_discord_token_here",
    "prefix": "/"
  }
}

使用方法

基本的な使用法

REST API スタイル

raw コマンドを使用して、Discord API とやり取りすることができます。

{
  "command": "raw",
  "endpoint": "/users/{user_id}",
  "method": "GET",
  "headers": {
    "Authorization": "Bearer your_discord_token_here"
  }
}

高度な使用法

Slash Command スタイル

slash コマンドを使用して、Slash コマンドを作成および管理できます。

{
  "command": "slash",
  "name": "ping",
  "description": "测试机器人是否正常运行。",
  "options": []
}

例

チャンネルの作成

以下の JSON リクエストを使用して、新しいチャンネルを作成できます。

{
  "command": "raw",
  "endpoint": "/guilds/{guild_id}/channels",
  "method": "POST",
  "headers": {
    "Authorization": "Bearer your_discord_token_here"
  },
  "body": {
    "name": "new-channel-name",
    "type": 0
  }
}

メッセージの送信

以下の JSON リクエストを使用して、指定したチャンネルにメッセージを送信できます。

{
  "command": "raw",
  "endpoint": "/channels/{channel_id}/messages",
  "method": "POST",
  "headers": {
    "Authorization": "Bearer your_discord_token_here"
  },
  "body": {
    "content": "Hello, Discord!"
  }
}

推奨事項

• ID の保存：作成したリクエストから返される ID を保存して、後で使用できるようにしましょう。
• Unicode 絵文字：メッセージに直接 Unicode 絵文字（例：\:champagne_glass:）を含めると、Claude Desktop がフリーズする可能性があります。Discord の絵文字を使用するようにモデルに指示してください。
• チャンネルタイプ：0 = テキスト、2 = ボイス、4 = カテゴリ、13 = ステージ
• ロールの色：10 進数形式で表現します（16 進数ではなく）。
• ほとんどの変更エンドポイント：PATCH メソッドを使用します。
• 空のペイロード：{} を使用し、null ではなくしてください。

📄 ライセンス

MIT License