DSH Discord User Assistant & MCP Plugin (@luoyi-dsh/discord-plugin)
A specialized smart assistant and Model Context Protocol (MCP) plugin designed for Discord User Accounts (Selfbot).
Fully integrated into the DeepSeek Harness (DSH) ecosystem, featuring two autonomous engines: Mention, Quote & DM Assistant and Autonomous Co-Chatting, alongside a complete suite of 13 MCP tools covering text, images, files, stickers, and emoji reactions.
Features native support for DSH Platform Subscriptions (Antigravity, Codex, Grok) for zero-API-key operation, and automatic seamless fallback when external API quotas are exhausted (HTTP 402 Insufficient Balance).
🌟 Key Features
- User Account Driven (Selfbot Engine):
- Uses user authorization tokens (not official bot tokens).
- Simulates human online presence states (
online, idle, dnd, invisible).
- Supports HTTP and SOCKS5 outbound proxies.
- Smart Reply Engine (Mentions, Quotes & DMs):
- @Mentions & Quote Replies: Automatically extracts recent channel conversation context and synthesizes reasoned responses under your identity.
- Direct Message (DM) Assistant: Handles 1-on-1 private inquiries autonomously.
- Round Cap Protection: Limits sequential conversational rounds per user to prevent infinite bot-to-bot loops.
- Autonomous Co-Chatting (Group Conversations):
- Real-time Gateway Monitoring: Maintains sliding message buffers across active channels.
- Context-Aware Participation: Weighs interest keywords, question detection, probability triggers, and channel-specific cooldowns to engage naturally in discussions.
[NO_REPLY] Introspection: LLM autonomously drops out if discussions are deemed sensitive, private, or inappropriate to interrupt.
- Anti-Ban Safety System:
- Human Typing Indicators (
sendTyping): Sends typing status prior to dispatching messages.
- Random Jitter Delay: Emulates 2–5 seconds human cognitive and keystroke latency.
- Whitelists, Blacklists & Quota Limits: Comprehensive rate-limiting controls to prevent spam flags.
- Multi-Tier LLM Reasoning Engine:
- Native integration with DSH Platform Subscriptions (e.g. Antigravity, Codex, Grok, Claude, Gemini) without requiring external API keys.
- Compatible with custom OpenAI / DeepSeek API endpoints with Automatic 402 Failover.
- Premium Web Settings Dashboard (
client.js):
- Single-bundle browser UI featuring token masking, live connection tests, KPI progress gauges, and real-time message dispatchers.
🚀 Installation
# Via DSH Plugin CLI (Recommended)
dsh plugin --profile web add @luoyi-dsh/discord-plugin
# Or via NPM
npm install @luoyi-dsh/discord-plugin
📖 Operational Guide & Tool Reference
For complete MCP tool definitions, natural language prompts, HTTP REST API routes, SDK invocation examples, and configuration parameters, please refer to AGENTS.md.
📁 Directory Structure
dsh-discord-plugin/
├── assets/
│ └── banner.png # Promotional banner
├── client.js # DSH Web UI dashboard
├── cordis.patch.yml # DSH bundle patch manifest
├── package.json # Package metadata and dependencies
├── tsconfig.json # TypeScript compiler settings
├── AGENTS.md # Operational & Agent Tool Guide
├── CHANGELOG.md # Version release notes
├── README.md # English overview (This file)
├── README.zh-Hant.md # Traditional Chinese overview
└── src/
├── index.ts # Cordis plugin entrypoint, Gateway dispatcher, and REST API
├── config.ts # Schemastery config schema
├── types.ts # TypeScript interfaces and types
├── mcp-server.ts # Standalone MCP Stdio entrypoint
├── lib/ # Selfbot client, state ledger, and unified LLM engine
├── duty/ # Mention/DM assistant & autonomous co-chatting duties
└── tools/ # 13 standard Discord MCP tools
📜 Releases & License
