discord-mcp: Instructions file for Claude Code

CLAUDE.md

Japanese <character_code>UTF-8</character_code>

プロジェクト概要

Discord APIとの統合機能を提供するMCP (Model Context Protocol) サーバーの実装です。MCPプロトコルを通じてClaude DesktopなどのAIクライアントがDiscord APIを安全に利用できるようにします。

技術スタック

• 言語: TypeScript
• フレームワーク: MCP SDK (@modelcontextprotocol/sdk)
• バリデーション: Zod
• コンテナ: Docker
• 実行環境: Node.js 22+
• テストフレームワーク: Vitest
• 主要ライブラリ: MCP SDK, axios (HTTP クライアント)

アーキテクチャ

設計方針

MCPプロトコル準拠: Model Context Protocolの仕様に完全準拠し、標準的なMCPクライアントとの互換性を保つ ドメイン分離: Discord API機能、MCPサーバーコア、ツール実装を明確に分離 型安全性: TypeScriptとZodを活用した厳密な型チェック セキュリティファースト: Discord Bot トークンの安全な管理と適切な権限制御

ディレクトリ構造

discord-mcp/
├── src/
│   ├── core/              # MCPサーバーのコア機能
│   │   └── tool-handler.ts    # 共通ツールハンドラー
│   ├── discord/           # Discord API統合機能
│   ├── tools/             # MCPツール実装（ドメイン別整理）
│   │   ├── registry.ts         # ツールレジストリ
│   │   ├── servers/           # サーバー関連ツール
│   │   ├── channels/          # チャンネル・メッセージ関連ツール
│   │   ├── users/             # ユーザー関連ツール
│   │   ├── roles/             # ロール関連ツール
│   │   └── docs/              # ツール固有ドキュメント
│   ├── types/             # 型定義
│   ├── utils/             # ユーティリティ関数
│   └── index.ts           # エントリーポイント（簡素化済み）
├── docs/                  # プロジェクト全体のドキュメント
│   ├── architecture/      # アーキテクチャ設計書
│   ├── api/               # Discord API仕様書
│   └── deployment/        # デプロイ手順
└── CLAUDE.md              # このファイル

ツール管理アーキテクチャ

ツールレジストリパターン: 各ツールファイルにMCP定義を含め、registry.tsで一元管理 動的ツール登録: index.tsはレジストリから動的にツール一覧を取得 共通ハンドラー: ToolHandlerクラスがDiscordクライアント初期化とエラーハンドリングを統一

開発ガイドライン

コーディング規約

• ファイル命名: kebab-case (例: discord-client.ts)
• クラス命名: PascalCase (例: DiscordMCPServer)
• 関数・変数命名: camelCase (例: setupToolHandlers)
• 定数命名: UPPER_SNAKE_CASE (例: DEFAULT_TIMEOUT)
• 型命名: PascalCase with suffix (例: DiscordMessageType)

開発フロー

• Git フロー: GitHub Flow (main ブランチからfeatureブランチを作成)
• レビュープロセス: Pull Request必須、1名以上のレビュー
• テスト戦略: ユニットテスト + 統合テスト (Jest使用予定)
• ツール追加時: 新しいMCPツールを追加した場合は、必ずTOOLLIST.md（日本語版・英語版）を更新