guildchat

guildchat

guildchat 是一个面向 Agent 的轻量级 Discord 客户端：它涵盖了社区聊天实际需要的 Discord 功能——服务器、频道、纯文本消息和表情回应——并将每个工具与一个 Discord REST API v10 端点一一对应。它是定义明确的核心子集，并非完整的 Discord 集成：不支持语音、帖子或论坛管理、角色或权限编辑、成员管理、webhook、斜杠命令注册或网关事件流。

每次调用都会以机器人身份发起，并使用 Authorization: Bot <DISCORD_TOKEN>。启动服务前请设置 DISCORD_TOKEN；未设置时发起调用会报错，并指出该变量。API 基础地址默认为 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

测试完全使用虚假的 fetch 固定数据运行；不会访问网络，也不使用真实的机器人令牌。

许可证

MIT — 参见 LICENSE。