使用说明内容（Markdown格式）

AdvancedDiscordMCP 服务器使用指南

项目简介
- 这是一个基于 MCP（Model Context Protocol）的服务器实现，专门为 Discord 场景提供后端能力，包括资源、工具、提示模板的统一管理，并通过 MCP 的 JSON-RPC 协议与客户端进行交互。它同时内置一个 Discord 机器人，用于在 Discord 服务器上执行工具调用与自动化任务，作为 MCP 客户端请求的执行端。
主要功能点
- MCP 核心能力
  - 资源管理：对外提供资源数据访问能力，供 LLM 客户端读取/写入。
  - 工具注册与执行：注册多种工具，LLM 客户端可调用执行外部功能。
  - 提示模板（Prompts）：定义与渲染可自定义的交互模板，便于模型对话场景定制。
  - 会话与能力声明：服务器端维护会话、能力描述等上下文信息。
- Discord 集成
  - 自动化工具集合：如列出服务器、查看服务器信息、管理频道/角色/成员、 Invites、 Moderation、Analytics 等等。
  - 通过 MCP 调用实现对 Discord 的操作（如发送消息、创建频道、分配角色、读取消息等）。
- 传输与协议
  - 使用 MCP 提供的 stdio(JSON-RPC) 传输通道，支持客户端通过标准输入输出的 JSON-RPC 请求进行交互。
- 安全性与扩展性
  - 会话管理、权限控制与错误处理设计，支持扩展新的工具与自动化规则。
安装步骤
1. 下载并安装依赖
  - 将项目克隆到本地
  - 使用 Python 虚拟环境执行：创建虚拟环境并激活
  - 安装依赖：在项目根目录执行 pip install -e .
2. 配置 Discord 机器人令牌
  - 在 Discord 开发者门户创建并获取机器人令牌，并确保开启必要的 intents。
3. 启动 MCP 服务器
  - 通过命令启动（客户端无需改动配置，MCP 客户端需要用到服务器信息）
  - 运行入口示例（请以实际环境路径为准）：python -m discord_mcp
4. 配置 MCP 客户端
  - MCP 客户端需要使用一个与服务器对应的配置（JSON），以便通过 MCP 协议与服务器建立连接。
  - 配置示例（需在客户端配置中使用，服务器端无需修改客户端代码）： { "mcpServers": { "discord": { "command": "python", "args": ["-m", "discord_mcp"], "cwd": "/path/to/AdvancedDiscordMCP", "env": { "DISCORD_TOKEN": "your_bot_token" } } } }
  - 说明：以上配置中 cwd 指向本仓库在你本地的根目录路径，DISCORD_TOKEN 为你在 Discord 开发者后台配置的 Bot Token。
服务器配置（MCP 客户端需要的配置信息，JSON 格式） { "mcpServers": { "discord": { "command": "python", "args": ["-m", "discord_mcp"], "cwd": "/path/to/AdvancedDiscordMCP", "env": { "DISCORD_TOKEN": "your_bot_token" } // 说明：cwd 为仓库在本地的根路径，DISCORD_TOKEN 为你的 Discord 机器人令牌 } } }
基本使用方法
- 启动后，MCP 客户端可以通过 JSON-RPC 请求调用已注册的工具、读取资源、获取 Prompts 等。
- 常见操作包括：列出 Discord 服务器、获取服务器信息、发送消息、创建频道、管理角色等。
- 通过工具列表（list_tools）了解当前服务器暴露的功能，并按需要调用对应工具名称与参数。
- 如需扩展新工具，调整服务器中注册的 Tool 列表即可。

关键词

AdvancedDiscordMCP 服务器使用指南

信息