Discordmcp

🚀 模型上下文協議（MCP）Discord服務器

模型上下文協議（MCP）服務器，允許大語言模型（LLM）與Discord頻道交互，藉助Discord的API實現消息的發送和讀取。使用此服務器，像Claude這樣的LLM可以直接與Discord頻道交互，同時保障用戶控制和安全性。

🚀 快速開始

模型上下文協議（MCP）服務器可讓LLM與Discord頻道進行交互。以下將為你介紹如何安裝和使用該服務器。

✨ 主要特性

• 🔘 發送消息到Discord頻道
• 🔘 讀取Discord頻道的最新消息
• 🔘 自動服務器和頻道發現
• 🔘 支持頻道名稱和ID
• 🔘 正確的錯誤處理和驗證

📦 安裝指南

先決條件

• Node.js 16.x或更高版本
• Discord機器人令牌
• 機器人必須以適當的權限邀請到您的服務器：
  • 閱讀消息/查看頻道
  • 發送消息
  • 閱讀消息歷史

安裝步驟

1. 克隆此倉庫：

git clone https://github.com/yourusername/discordmcp.git
cd discordmcp

2. 安裝依賴項：

npm install

3. 在根目錄創建一個.env文件，包含您的Discord機器人令牌：

DISCORD_TOKEN=your_discord_bot_token_here

4. 構建服務器：

npm run build

💻 使用示例

使用Claude桌面版

1. 打開您的Claude桌面版配置文件：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. 添加Discord MCP服務器配置：

{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": ["path/to/discordmcp/build/index.js"],
      "env": {
        "DISCORD_TOKEN": "your_discord_bot_token_here"
      }
    }
  }
}

3. 重啟Claude桌面版

可用工具

send - message

向指定的Discord頻道發送消息。

參數：

• server（可選）：服務器名稱或ID（如果機器人在多個服務器中，則必需）
• channel：頻道名稱（例如，“general”）或ID
• message：要發送的消息內容

示例：

{
  "channel": "general",
  "message": "來自MCP的問候！"
}

read - messages

讀取指定Discord頻道的最新消息。

參數：

• server（可選）：服務器名稱或ID（如果機器人在多個服務器中，則必需）
• channel：頻道名稱（例如，“general”）或ID
• limit（可選）：要獲取的消息數量（默認：50，最大：100）

示例：

{
  "channel": "general",
  "limit": 10
}

實際使用示例

以下是設置好Discord MCP服務器後可以嘗試與Claude互動的一些示例：

1. “你能讀取通用頻道的最後5條消息嗎？”
2. “請向公告頻道發送一條消息，內容為‘會議將在10分鐘後開始’”
3. “開發頻道關於最新版本的消息中最 recent的是什麼？”

Claude將使用適當的工具與Discord交互，並在發送任何消息之前徵求您的批准。

📚 詳細文檔

開發

1. 安裝開發依賴項：

npm install --save-dev typescript @types/node

2. 在開發模式下啟動服務器：

npm run dev

測試

您可以通過MCP Inspector測試服務器：

npx @modelcontextprotocol/inspector node build/index.js

🔧 技術細節

安全注意事項

• 機器人需要適當的Discord權限才能運行
• 所有消息發送操作都需要明確的用戶批准
• 環境變量應妥善保管
• 令牌絕不能提交到版本控制
• 頻道訪問僅限於機器人已獲得訪問權限的頻道

貢獻

1. 叉倉庫
2. 創建功能分支（git checkout -b feature/amazing - feature）
3. 提交更改（git commit -m '添加一些驚人的功能'）
4. 推送到分支（git push origin feature/amazing - feature）
5. 打開Pull Request

📄 許可證

此項目根據MIT許可證發佈，詳細信息請參閱LICENSE文件。

支持

如果您遇到任何問題或有疑問：

1. 檢查GitHub Issues部分
2. 諮詢MCP文檔https://modelcontextprotocol.io
3. 使用詳細的重現步驟打開新問題