Skip to main content

Discord Message Context Provider for Claude

Project description

Discord MCP

Discord Message Context Provider for Claude - Enables Claude to search and access Discord messages through the Model Context Protocol (MCP).

Features

  • Connect Claude to your Discord messages using MCP
  • Search messages with BM25 relevance scoring
  • Export Discord channels using DiscordChatExporter
  • Web UI for configuration and monitoring
  • Docker support for containerized deployment

Installation

Using pipx (Recommended)

pipx install discord-mcp

Using pip

pip install discord-mcp

Usage

Setting up Claude Desktop

Configure Claude Desktop to connect to the Discord MCP server by adding the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "discord-mcp": {
      "command": "pipx",
      "args": [
        "run", 
        "discord-mcp"
      ],
      "env": {
        "DISCORD_DATA_URL": "http://your-server-ip:8081"
      }
    }
  }
}

Running the MCP Server

discord-mcp

Running the Web UI

discord-webui

Configuration

Create a .env file with the following variables:

DISCORD_DATA_DIR=/absolute/path/to/discord_data
DISCORD_USER_TOKEN=your_discord_token
DISCORD_WEBUI_PORT=8080
DISCORD_WEBUI_HOST=0.0.0.0

Important: DISCORD_DATA_DIR must be an absolute path, especially when running in read-only environments like Claude Desktop with pipx.

Docker Deployment

docker-compose up -d

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

discord_mcp-0.1.4.tar.gz (81.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

discord_mcp-0.1.4-py3-none-any.whl (93.4 kB view details)

Uploaded Python 3

File details

Details for the file discord_mcp-0.1.4.tar.gz.

File metadata

  • Download URL: discord_mcp-0.1.4.tar.gz
  • Upload date:
  • Size: 81.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for discord_mcp-0.1.4.tar.gz
Algorithm Hash digest
SHA256 29c3643982632108de91c19dc2c32a5643f595f3a638271fa251820246179400
MD5 929193a74bd657468e618ca15ae8c93c
BLAKE2b-256 c3e4153da041b8936703f7aa967f2663013d2081c91666ffe4ea572ce4c57c1d

See more details on using hashes here.

File details

Details for the file discord_mcp-0.1.4-py3-none-any.whl.

File metadata

  • Download URL: discord_mcp-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 93.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for discord_mcp-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 f3e05599c79f934c1c776d4dffac6e3a84adba97a20f89b24685d666c3778956
MD5 6199b050566ec7e6f34d0f761bb8a7c1
BLAKE2b-256 4f71bc149301ff7dcb6f97e48199319b209ab3a68a943a1c20b53b230e250eee

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page