guildchat

guildchat

guildchat はエージェント向けの小規模な Discord クライアントです。コミュニティチャットの作業で実際に必要となる Discord の機能、つまりギルド、チャンネル、プレーンテキストメッセージ、リアクションをカバーし、各ツールを Discord REST API v10 のエンドポイントに 1 対 1 で対応付けます。これは明確に定義されたコア機能のサブセットであり、Discord の完全な統合ではありません。ボイス、スレッドやフォーラムの管理、ロールや権限の編集、メンバーのモデレーション、Webhook、スラッシュコマンドの登録、ゲートウェイイベントストリームには対応していません。

すべての呼び出しは Authorization: Bot <DISCORD_TOKEN> を使ってボットとして行われます。サーバーの起動前に DISCORD_TOKEN を設定してください。未設定の状態で呼び出すと、変数名を示すエラーが発生します。API のベース URL はデフォルトで https://discord.com/api/v10 です。DISCORD_API_BASE で上書きできます。

インストール

npx @reneturcios/guildchat list_guilds
docker run -i ghcr.io/cloudcorprecords/guildchat

CLI

guildchat list_guilds
guildchat get_guild <guild_id>
guildchat list_channels <guild_id>
guildchat send_message <channel_id> hello everyone
guildchat read_messages <channel_id> --limit 25
guildchat add_reaction <channel_id> <message_id> 👍
guildchat get_current_user
guildchat --version

終了コード：0 は成功、1 は API エラー、2 は使用方法のエラーです。

MCP サーバー

npx -y @reneturcios/guildchat mcp

{
  "mcpServers": {
    "guildchat": {
      "command": "npx",
      "args": ["-y", "@reneturcios/guildchat", "mcp"],
      "env": { "DISCORD_TOKEN": "your-bot-token" }
    }
  }
}

ツール

ツール	入力	Discord エンドポイント
list_guilds	—	GET /users/@me/guilds
get_guild	guild_id	GET /guilds/{id}
list_channels	guild_id	GET /guilds/{id}/channels
get_channel	channel_id	GET /channels/{id}
send_message	channel_id, content	POST /channels/{id}/messages
read_messages	channel_id, limit?, before?	GET /channels/{id}/messages
edit_message	channel_id, message_id, content	PATCH /channels/{id}/messages/{mid}
delete_message	channel_id, message_id	DELETE /channels/{id}/messages/{mid}
add_reaction	channel_id, message_id, emoji	PUT /channels/{id}/messages/{mid}/reactions/{emoji}/@me
get_current_user	—	GET /users/@me

リアクションの絵文字は、Discord の仕様に従ってリクエストパス内で URL エンコードされます。上流の HTTP エラーは、ステータスとレスポンスの詳細を含むツールエラーとして報告されます。

開発

npm install
npm run build
npm test

テストはすべて fake-fetch フィクスチャ上で実行されます。ネットワークや実際のボットトークンは使用しません。

ライセンス

MIT — LICENSE を参照してください。