Discord MCP Server

English README

Discord API MCP (Model Context Protocol) Server - Discord機能をMCP対応クライアントと統合するためのTypeScript実装です。

機能

• Zodバリデーションを使用したTypeScript実装
• 簡単なデプロイのためのDockerサポート
• MCPプロトコル準拠
• Discord API統合

利用可能なツール

利用可能なツールの詳細については、ツール一覧を参照してください。

要件

• Docker
• Docker Compose（オプション）

インストール

# リポジトリをクローン
git clone https://github.com/yourusername/discord-mcp.git
cd discord-mcp

# Dockerイメージをビルド
docker build -t discord-mcp .

MCP設定

Claude Desktop

1. Claude Desktopの設定ファイルを編集します：

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

2. 以下の設定を追加します：

Dockerを使用する場合（推奨）

{
  "mcpServers": {
    "discord-mcp": {
      "command": "docker",
      "args": [
        "run", 
        "--rm", 
        "-e", "DISCORD_TOKEN=your_discord_bot_token",
        "discord-mcp"
      ]
    }
  }
}

ローカルビルドを使用する場合

{
  "mcpServers": {
    "discord-mcp": {
      "command": "node",
      "args": ["/path/to/discord-mcp/dist/index.js"],
      "env": {
        "DISCORD_TOKEN": "your_discord_bot_token"
      }
    }
  }
}

開発環境での設定

{
  "mcpServers": {
    "discord-mcp-dev": {
      "command": "npx",
      "args": ["ts-node", "/path/to/discord-mcp/src/index.ts"],
      "cwd": "/path/to/discord-mcp",
      "env": {
        "DISCORD_TOKEN": "your_discord_bot_token",
        "LOG_LEVEL": "debug"
      }
    }
  }
}

その他のMCPクライアント

stdio方式で接続できる任意のMCPクライアントから利用できます：

# Dockerで直接実行
docker run --rm -e DISCORD_TOKEN=your_discord_bot_token discord-mcp

使用方法

Docker（推奨）

# 基本実行
docker run --rm -e DISCORD_TOKEN=your_discord_bot_token discord-mcp

# Docker Composeを使用
docker-compose up --build

開発環境（ローカル開発用）

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

# 開発モードで開始
npm run dev

スクリプト

• npm run build - TypeScriptをJavaScriptにコンパイル
• npm run start - 本番サーバーを開始
• npm run dev - ts-nodeを使用して開発モードで開始
• npm run lint - ESLintを実行
• npm run typecheck - TypeScriptの型チェックを実行
• npm run docker:build - Dockerイメージをビルド

プロジェクト構造

discord-mcp/
├── src/
│   └── index.ts          # メインサーバー実装
├── dist/                 # コンパイル済みJavaScript出力
├── Dockerfile            # Docker設定
├── docker-compose.yml    # Docker Compose設定
├── package.json          # プロジェクト依存関係とスクリプト
├── tsconfig.json         # TypeScript設定
└── README.md             # このファイル

設定ガイド

Discord Bot の設定

1. Discord Developer Portalにアクセス
2. 新しいApplicationを作成
3. Bot タブでBot トークンを取得
4. OAuth2 → URL Generatorで以下の権限を設定：
   • bot スコープ
   • Send Messages 権限
   • Read Message History 権限
5. 生成されたURLでDiscordサーバーに招待

環境変数の設定

# Discord Bot トークンを設定
export DISCORD_TOKEN="your_discord_bot_token_here"

# ログレベルの設定（オプション）
export LOG_LEVEL="info"  # debug, info, warn, error

設定確認のコマンド

# Claude Desktop設定ファイルの確認 (macOS)
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

# JSON形式の検証
python -m json.tool ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Dockerイメージの確認
docker images | grep discord-mcp

ライセンス

MIT License - 詳細はLICENSEファイルを参照してください。