Fracture

An MCP (Model Context Protocol) server that provides Discord tools. Built with the MCP Ruby SDK and discordrb.

Requirements

• Ruby 4.0+
• A Discord bot token (create one here)

Installation

git clone https://github.com/yourusername/fracture.git
cd fracture
bundle install

Configuration

Set your Discord bot token as an environment variable:

export DISCORD_BOT_TOKEN=your_token_here

Claude Desktop

Add to your Claude Desktop MCP config (claude_desktop_config.json):

{
  "mcpServers": {
    "fracture": {
      "command": "ruby",
      "args": ["/path/to/fracture/fracture.rb"],
      "env": {
        "DISCORD_BOT_TOKEN": "your_token_here"
      }
    }
  }
}

On Windows, you may also need to set DISCORDRB_NONACL=1 in the env block.

Usage

Run the server directly over stdio:

ruby fracture.rb

The server communicates via stdin/stdout using the MCP JSON-RPC protocol.

Tools

Guilds

Tool	Description	Arguments
get_guilds	Lists all guilds (servers) the bot is a member of. Returns each guild's ID and name.	None
get_guild	Gets detailed information about a specific guild, including its categories, channels, and members. For guilds with fewer than 100 members, full member details are returned; otherwise only the member count is included.	guild_id (string, required)
get_guild_members	Lists all members of a guild. Reserved for large servers with more than 100 members. Returns each member's ID, username, and display name.	guild_id (string, required)

Bans

Tool	Description	Arguments
ban_user	Bans a user from a guild.	guild_id (string, required), user_id (string, required), reason (string, required)
unban_user	Unbans a user from a guild.	guild_id (string, required), user_id (string, required), reason (string, required)
get_guild_bans	Lists all bans for a guild. Returns each ban's user ID and reason.	guild_id (string, required)

Members

Tool	Description	Arguments
get_member	Gets detailed information about a guild member, including their roles, status, join date, voice state, and more.	guild_id (string, required), member_id (string, required)
add_role	Adds a role to a guild member.	guild_id (string, required), member_id (string, required), role_id (string, required)
remove_role	Removes a role from a guild member.	guild_id (string, required), member_id (string, required), role_id (string, required)

Messages

Tool	Description	Arguments
send_message	Sends a message to a channel or user via DM. Specify either guild_id + channel_id for a channel message, or user_id for a DM. At least one of content or attachments must be provided.	guild_id (string, optional), channel_id (string, optional), user_id (string, optional), content (string, optional), attachments (string[], optional)
edit_message	Edits an existing message in a channel or DM.	message_id (string, required), content (string, required), guild_id (string, optional), channel_id (string, optional), user_id (string, optional)
delete_message	Deletes a message from a channel or DM.	message_id (string, required), guild_id (string, optional), channel_id (string, optional), user_id (string, optional)

Roles

Tool	Description	Arguments
get_guild_roles	Gets all roles for a guild, including decoded permissions for each role.	guild_id (string, required)
create_role	Creates a new role in a guild.	guild_id (string, required), name (strin

... View full README on GitHub