Discordmcp

🚀 モデルコンテキストプロトコル（MCP）Discordサーバー

このプロジェクトは、モデルコンテキストプロトコル（MCP）サーバーです。LLM（大規模言語モデル）がDiscordチャンネルと直接やり取りできるようにし、DiscordのAPIを通じてメッセージの送受信を可能にします。ClaudeのようなLLMが、ユーザーの制御とセキュリティを維持しながらDiscordチャンネルとやり取りできます。

✨ 主な機能

• Discordチャンネルにメッセージを送信する
• Discordチャンネルの最新メッセージを読み取る
• 自動的なサーバーとチャンネルの検出
• チャンネル名とIDのサポート
• 適切なエラー処理と検証

📦 インストール

前提条件

• Node.js 16.x以上
• Discordボットトークン
• ボットは適切な権限でサーバーに招待されている必要があります：
  • メッセージを読む/チャンネルを表示する
  • メッセージを送信する
  • メッセージ履歴を読む

インストール手順

1. このリポジトリをクローンします：

git clone https://github.com/yourusername/discordmcp.git
cd discordmcp

2. 依存関係をインストールします：

npm install

3. ルートディレクトリに.envファイルを作成し、Discordボットトークンを記述します：

DISCORD_TOKEN=your_discord_bot_token_here

4. サーバーをビルドします：

npm run build

💻 使用例

Claudeデスクトップ版の使用方法

1. Claudeデスクトップ版の設定ファイルを開きます：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Discord MCPサーバーの設定を追加します：

{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": ["path/to/discordmcp/build/index.js"],
      "env": {
        "DISCORD_TOKEN": "your_discord_bot_token_here"
      }
    }
  }
}

3. Claudeデスクトップ版を再起動します。

利用可能なツール

send - message

指定したDiscordチャンネルにメッセージを送信します。

パラメーター：

• server（オプション）：サーバー名またはID（ボットが複数のサーバーに存在する場合は必須）
• channel：チャンネル名（例：“general”）またはID
• message：送信するメッセージ内容

例：

{
  "channel": "general",
  "message": "来自MCP的问候！"
}

read - messages

指定したDiscordチャンネルの最新メッセージを読み取ります。

パラメーター：

• server（オプション）：サーバー名またはID（ボットが複数のサーバーに存在する場合は必須）
• channel：チャンネル名（例：“general”）またはID
• limit（オプション）：取得するメッセージ数（デフォルト：50、最大：100）

例：

{
  "channel": "general",
  "limit": 10
}

サンプル会話

以下は、Discord MCPサーバーを設定した後、Claudeとやり取りできる例です。

• “あなたは一般チャンネルの最後の5つのメッセージを読むことができますか？”
• “会議は10分後に始まります”というメッセージをお知らせチャンネルに送信してください”
• “開発チャンネルの最新バージョンに関する最新のメッセージは何ですか？”

Claudeは適切なツールを使用してDiscordとやり取りし、メッセージを送信する前にユーザーの承認を求めます。

🔧 開発

開発用依存関係のインストール

npm install --save-dev typescript @types/node

開発モードでサーバーを起動

npm run dev

テスト

MCP Inspectorを使用してサーバーをテストできます：

npx @modelcontextprotocol/inspector node build/index.js

⚠️ セキュリティに関する注意事項

• ボットが適切なDiscord権限を持っている必要があります
• すべてのメッセージ送信操作にはユーザーの明示的な承認が必要です
• 環境変数は適切に保管する必要があります
• トークンをバージョン管理にコミットしないでください
• チャンネルへのアクセスは、ボットがアクセス権を持っているチャンネルに限定されます

🤝 貢献方法

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m '添加一些惊人的功能'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. Pull Requestを作成します

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。

🛠️ サポート

問題が発生した場合や質問がある場合は：

1. GitHubのIssuesセクションを確認してください
2. MCPドキュメントhttps://modelcontextprotocol.io を参照してください
3. 詳細な再現手順を記載して新しい問題を登録してください