English Français العربية

io.github.CloudCorpRecords/guildchat

السجل الرسمي أخرى

Discord guild and channel messaging via REST API v10: guilds, channels, messages and reactions.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @reneturcios/guildchat
Claude Code 
claude mcp add guildchat -- npx -y @reneturcios/guildchat@0.1.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "guildchat": {
            "command": "npx",
            "args": [
                "-y",
                "@reneturcios/guildchat@0.1.0",
                "mcp"
            ]
        }
    }
}
OCI package ghcr.io/cloudcorprecords/guildchat:0.1.0
Claude Code 
claude mcp add guildchat -- docker run -i --rm ghcr.io/cloudcorprecords/guildchat:0.1.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "guildchat": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/cloudcorprecords/guildchat:0.1.0",
                "mcp"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. guildchat
  2. Install
  3. CLI
  4. MCP server
  5. Development
  6. License

guildchat

guildchat is a small Discord client for agents: it covers the part of Discord that community chat work actually needs — guilds, channels, plain-text messages, and reactions — and maps each tool 1:1 to a Discord REST API v10 endpoint. It is a defined core subset, not a full Discord integration: there is no voice, no thread or forum management, no role or permission editing, no member moderation, no webhooks, no slash-command registration, and no gateway event stream.

Every call is made as a bot, with Authorization: Bot <DISCORD_TOKEN>. Set DISCORD_TOKEN before starting the server; a call made without it fails with an error naming the variable. The API base defaults to https://discord.com/api/v10 and can be overridden with DISCORD_API_BASE.

Install

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

Exit codes: 0 success, 1 API error, 2 usage error.

MCP server

npx -y @reneturcios/guildchat mcp
{
  "mcpServers": {
    "guildchat": {
      "command": "npx",
      "args": ["-y", "@reneturcios/guildchat", "mcp"],
      "env": { "DISCORD_TOKEN": "your-bot-token" }
    }
  }
}
Tools
ToolInputDiscord endpoint
list_guilds—GET /users/@me/guilds
get_guildguild_idGET /guilds/{id}
list_channelsguild_idGET /guilds/{id}/channels
get_channelchannel_idGET /channels/{id}
send_messagechannel_id, contentPOST /channels/{id}/messages
read_messageschannel_id, limit?, before?GET /channels/{id}/messages
edit_messagechannel_id, message_id, contentPATCH /channels/{id}/messages/{mid}
delete_messagechannel_id, message_idDELETE /channels/{id}/messages/{mid}
add_reactionchannel_id, message_id, emojiPUT /channels/{id}/messages/{mid}/reactions/{emoji}/@me
get_current_user—GET /users/@me

Reaction emoji are URL-encoded into the request path, as Discord requires. Upstream HTTP errors are reported as tool errors with the status and response detail.

Development

npm install
npm run build
npm test

Tests run entirely on fake-fetch fixtures; no network and no real bot token are used.

License

MIT — see LICENSE.

الأسئلة الشائعة

ما هو io.github.CloudCorpRecords/guildchat؟

Discord guild and channel messaging via REST API v10: guilds, channels, messages and reactions.

كيف أثبّت io.github.CloudCorpRecords/guildchat؟

يعمل على جهازك. في Claude Code: claude mcp add guildchat -- npx -y @reneturcios/guildchat@0.1.0 mcp. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.CloudCorpRecords/guildchat إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.CloudCorpRecords/guildchat مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.CloudCorpRecords/guildchat؟

ينشره CloudCorpRecords. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.