The Final Discord MCP

索伦之眼-不和谐机器人

一个Discord机器人，具有人工智能聊天、语音TTS、《战舰世界》统计数据和用于人工智能助手的MCP（模型上下文协议）集成。

特性

• AI聊天 -由OpenRouter提供支持，拥有34+免费AI模型（Gemini、Llama、Qwen等）
• 语音TTS -具有20+Microsoft Edge神经语音的自然文本到语音
• WoWS统计数据 -从Wargaming API查找玩家统计数据和部落信息
• 节制 -禁止、踢、超时、批量删除消息
• 服务器管理 -创建渠道、角色、类别
• MCP集成 -93个AI辅助控制工具（Claude等）
• HTTP API -用于web集成的可选REST API模式
• DM支持 -Bot在私人消息中自动响应（不需要前缀）

快速开始

先决条件

• Node.js 18+
• Discord机器人令牌
• （可选）用于AI功能的OpenRouter API密钥

1.克隆和安装

git clone https://github.com/DawnReaverWOWS/TheFinalDiscordMCP.git
cd TheFinalDiscordMCP
npm install

2.配置

复制示例环境文件并对其进行编辑：

cp .env.example .env

编辑 .env:

# Required
DISCORD_TOKEN=your_bot_token_here
DISCORD_GUILD_ID=your_server_id_here

# AI Features (Optional but recommended)
OPENROUTER_API_KEY=your_openrouter_api_key_here

# Creator Configuration (Optional)
BOT_CREATOR_ID=your_discord_user_id
BOT_CREATOR_NAME=YourName

# Notifications (Optional)
BOT_NOTIFY_CHANNEL_ID=channel_id_for_bot_notifications

3.构建和运行

npm run build
npm start

对于热重载开发：

npm run dev

获取Discord Bot令牌

1. 首选 Discord开发者门户
2. 点击“新建应用程序”并为其命名
3. 转到“Bot”选项卡->“添加Bot”
4. 点击“重置令牌”并复制它（这是您的 DISCORD_TOKEN)
5. 启用这些特权网关意图：

- 出席意向 - 服务器成员意图 - 消息内容意图

1. 转到“OAuth2”->“URL生成器”
2. 选择范围： bot, applications.commands
3. 选择权限： Administrator （或选择个人权限）
4. 复制生成的URL并打开它以邀请机器人到您的服务器

人工智能集成

使用OpenRouter访问34+免费AI模型。获取API密钥： openrouter.ai/keys.

支持的免费型号

看 context/openrouterAiModels.md 查看34款免费型号的完整列表。

使用人工智能

• 提及机器人: @BotName what's the best ship for ranked?
• DM机器人：只需直接发送消息-不需要前缀
• 机器人将以上下文感知的答案进行响应

机器人命令

所有命令都使用 ! 前缀（不含前缀的DM除外）。

人工智能和聊天

语音

别名： !vc （加入）， !disconnect （离开）， !speak/!tts （说）

可用TTS语音

20+自然微软Edge神经声音：

美国女性： 咏叹调（默认）、珍妮、萨拉、安娜、米歇尔 美国男性： 盖伊，戴维斯，托尼，杰森 英国女性： 索尼亚、梅西、利比 英国男： 瑞安、托马斯、阿尔菲 澳大利亚人： 威廉娜塔莎

战舰世界

别名： !player, !lookup （对于wows）， !topships （对于船舶）， !claninfo, !clanlookup （氏族）

舰艇指挥选项：

• 按层筛选： !ships PlayerName tier:10
• 按类型筛选： !ships PlayerName type:bb （dd、ca、bb、cv、ss）
• 排序选项： !ships PlayerName sort:winrate （战斗、胜率、伤害、最近）

信息

审核（需要权限）

别名： !b （禁令）， !k （踢腿）， !mute/!to （超时）， !clear/!purge （bulkdelete）

消息

频道（仅限管理员）

角色

效用

乐趣

别名： !breadsticks, !breadstick, !carbs

创建者模式

该机器人支持语音命令的“创建者优先级”系统：

• 集 BOT_CREATOR_ID 在 .env 到您的Discord用户ID
• 使用 !lockvoice 仅将语音命令锁定到创建者
• 锁定时，只有创建者可以控制语音功能
• 使用 !unlockvoice 再次允许所有人

当被问及其创建者时，机器人会高度评价他们！

MCP集成（适用于AI助理）

这个机器人还充当MCP服务器，允许像克劳德这样的人工智能助手控制Discord。

Claude桌面配置

添加到您的Claude桌面配置(~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": ["/path/to/FinalDiscordMCP/dist/index.js"],
      "env": {
        "DISCORD_TOKEN": "your_token_here",
        "DISCORD_GUILD_ID": "your_server_id",
        "OPENROUTER_API_KEY": "your_openrouter_key"
      }
    }
  }
}

HTTP API模式

从启用HTTP API开始：

MCP_HTTP_PORT=3001 npm start

或者在HTTP-only模式下运行（没有Discord机器人，只有API）：

HTTP_ONLY=true MCP_HTTP_PORT=3001 npm start

环境变量

项目结构

TheFinalDiscordMCP/
├── src/
│   ├── index.ts              # Entry point
│   ├── discord-service.ts    # Discord.js wrapper
│   ├── ai-service.ts         # OpenRouter AI integration
│   ├── voice-settings.ts     # TTS voice configuration
│   ├── voice-priority.ts     # Creator voice lock system
│   ├── commands/
│   │   ├── decorated-commands.ts  # Bot commands
│   │   └── prefix-handler.ts      # Command routing & AI
│   ├── services/
│   │   └── wargaming-api.ts  # WoWS API integration
│   ├── decorators/
│   │   └── prefix.ts         # Command decorators
│   └── core/
│       ├── DiscordController.ts
│       ├── ConfigManager.ts
│       ├── RateLimiter.ts
│       └── ...
├── context/
│   └── openrouterAiModels.md # Full list of 34 free AI models
├── dist/                     # Compiled JS
├── .env                      # Your config (not committed)
├── .env.example              # Example config
└── package.json

部署

该机器人包括用于自动部署的GitHub Actions工作流：

• 持续集成 -在所有推送、构建和测试中运行
• 部署 -在推送到主服务器时部署到VM1和VM2

看 .github/workflows/ 用于配置。

发展

# Install dependencies
npm install

# Run in dev mode (hot reload)
npm run dev

# Build for production
npm run build

# Run production build
npm start

# Type check
npx tsc --noEmit

许可证

麻省理工学院-参见 许可证