MCP Discord Assistant

🤖 Discord助手（MCP+Ollama）

一个强大的Discord管理助手，利用 模型上下文协议（MCP） 和 奥拉玛 本地隐私优先情报。此项目提供了多个界面来与您的Discord服务器交互，包括自定义Streamlit仪表板和与Claude Desktop的直接集成。

______________________________________________________________________

🚀 快速开始

1.先决条件

• Python 3.14+ （通过管理 uv)
• 奥拉玛 安装并运行。
• Discord Bot令牌：在 Discord开发者门户 和 Message Content 和 Server Members 意图启用。

2.设置

克隆存储库并安装依赖项：

# Install dependencies
uv sync

设置环境变量： 创建一个 .env 根目录中的文件：

DISCORD_BOT_TOKEN=your_token_here

3.拉动大脑

我们建议使用 问题2.5（7B） 为了实现可靠的工具调用：

ollama pull qwen2.5:7b

______________________________________________________________________

🛠 用法

🎨 流媒体应用程序（Web UI）

启动交互式web界面与您的Discord助手聊天：

uv run streamlit run streamlit_app.py

🤖 Discord机器人

直接运行机器人，使其驻留在您的Discord服务器中：

uv run run_bot.py

🔌 克劳德桌面集成（MCP）

要在Claude Desktop中直接使用这些Discord工具：

1. 运行MCP安装命令：

   uv run mcp install run_mcp.py

1. 重新启动克劳德桌面 完全（从系统托盘退出）。
2. 寻找🔌 图标开始使用Discord工具！

______________________________________________________________________

📁 项目结构

• app/：核心应用程序逻辑。

- mcp/：MCP服务器工具定义（通道、消息、角色等）。 - discord/：Discord机器人实现。

• streamlit_app.py：Qwen驱动的网络仪表板。
• run_mcp.py：MCP服务器的入口点。
• run_bot.py：独立Discord机器人的入口点。
• main.py：MCP基本功能的快速入门演示（Notes工具）。

______________________________________________________________________

🛠 可用工具

助理配备了以下工具：

• 📢 渠道管理：创建、列出和删除频道。
• 💬 消息传递：读取历史记录、发送消息和管理线程。
• 👥 用户/角色管理：列出角色，获取用户信息。
• 📊 察看连接信息：审核日志和公会统计。
• 🤖 自动化：用于机器人特定任务的工具。

______________________________________________________________________

⚖️ 许可证

MIT许可证。看 LICENSE 了解详情。