discord-selfbot-mcp 1.2.7 → 1.3.0

package/README.md

@@ -186,6 +186,7 @@ powered by the robust `discord.py-self` library.
 | **system** | 2 | get_user_info, list_guilds |
 | **messages** | 6 | send_message, read_messages, search_messages, edit_message, delete_message, get_message_attachments |
 | **channels** | 3 | create_channel, delete_channel, list_channels |
+| **dms** | 1 | list_dm_channels |
 | **voice** | 2 | join_voice_channel, leave_voice_channel |
 | **relationships** | 4 | list_friends, send_friend_request, add_friend, remove_friend |
 | **presence** | 2 | set_status, set_activity |
@@ -197,11 +198,42 @@ powered by the robust `discord.py-self` library.
 | **reactions** | 2 | add_reaction, remove_reaction |
 | **discrawl** | 7 | run_discrawl, discrawl_doctor, discrawl_status, discrawl_sync, discrawl_search, discrawl_messages, discrawl_mentions |
 
+### direct messages
+
+`list_dm_channels` enumerates your open 1:1 and group DM channels so you can
+discover a `channel_id` instead of needing to know it in advance. Each row is
+`<channel_id> - [dm|group] <recipient display> (id=<user_id>) [BOT]`. Optional
+args: `include_groups` (default `true`) and `name_contains` (case-insensitive
+filter on recipient name/handle), e.g. find the DM with a person by name and
+feed the id straight into `read_messages` / `send_message`.
+
+### slash commands
+
+`send_slash_command` invokes an application command in a channel or DM. Pass
+`application_id` (the bot's user/application ID) for reliable resolution; in a DM
+with a bot it is inferred automatically. The command and any options are
+resolved from the application's registered command list
+(`GET /applications/{id}/commands`), which works for ordinary guild-installed
+bots whose commands the per-channel `/` search index does not return. Subcommands
+are space-separated in `command_name` (e.g. `"config set"`). Example:
+
+```json
+{
+  "channel_id": "123456789012345678",
+  "command_name": "remind",
+  "application_id": "987654321098765432",
+  "options": { "text": "stand up", "when": "in 10 minutes" }
+}
+```
+
 ### discrawl integration
 
 Use `run_discrawl` to execute local `discrawl` commands directly from MCP.
 Use typed tools for common operations (`discrawl_sync`, `discrawl_search`, `discrawl_messages`, etc.) when you want structured params.
-This fork prefers a sibling checkout at `../discrawl-self/bin/discrawl` when present, then falls back to `discrawl` in `PATH`.
+By default this MCP uses the Microck fork at `../discrawl-self/bin/discrawl`:
+`https://github.com/Microck/discrawl-self`. It does not silently fall back to a
+global `discrawl` from `PATH`; set `DISCRAWL_BIN` or the tool `binary` argument
+when you intentionally want another executable.
 
 Example tool call payload:
 
@@ -229,7 +261,7 @@ Typed tool payload example:
 
 Optional env var:
 
-- `DISCRAWL_BIN` - custom path to discrawl executable. This overrides the default fork-first lookup.
+- `DISCRAWL_BIN` - custom path to discrawl executable. This overrides the default Microck fork lookup.
 
 ### attachment access
 
@@ -336,6 +368,7 @@ discord_py_self_mcp/
 │   └── solver.py
 └── tools/
     ├── channels.py
+    ├── dms.py
     ├── discrawl.py
     ├── embed.py
     ├── guilds.py
@@ -377,6 +410,8 @@ python3 scripts/dcli.py daemon status    # check daemon status
 python3 scripts/dcli.py send-message --channel CHANNEL_ID --content "Hello"
 python3 scripts/dcli.py list-guilds
 python3 scripts/dcli.py read-messages --channel CHANNEL_ID --limit 20
+python3 scripts/dcli.py get-message-attachments --channel CHANNEL_ID --message MESSAGE_ID
+python3 scripts/dcli.py get-message-attachments --channel CHANNEL_ID --message MESSAGE_ID --download --output-dir ./attachments
 ```
 
 **when to use skill mode**:

package/SKILL.md

@@ -66,8 +66,11 @@ This server also exposes dedicated MCP tools to run local `discrawl` commands:
 - `discrawl_messages`
 - `discrawl_mentions`
 
-By default this MCP prefers a sibling fork build at `../discrawl-self/bin/discrawl`, then falls back to `discrawl` in `PATH`.
-Use `DISCRAWL_BIN` if you want to override that:
+By default this MCP uses the Microck fork build at `../discrawl-self/bin/discrawl`
+from `https://github.com/Microck/discrawl-self`. It does not silently fall back
+to a global `discrawl` from `PATH`.
+
+Use `DISCRAWL_BIN` if you want to intentionally override that:
 
 ```bash
 DISCRAWL_BIN=/absolute/path/to/discrawl

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "discord-selfbot-mcp",
-  "version": "1.2.7",
+  "version": "1.3.0",
   "description": "Discord Selfbot MCP server - Node.js wrapper for Python implementation",
   "main": "index.js",
   "bin": {

package/scripts/daemon.py

@@ -5,6 +5,7 @@ Auto-restart on code change: Enabled
 """
 
 import asyncio
+import base64
 import hashlib
 import json
 import os
@@ -17,8 +18,13 @@ from datetime import datetime, timedelta, timezone
 from pathlib import Path
 from secrets import compare_digest
 
+SCRIPT_DIR = Path(__file__).resolve().parent
+PROJECT_ROOT = SCRIPT_DIR.parent
+if str(PROJECT_ROOT) not in sys.path:
+    sys.path.insert(0, str(PROJECT_ROOT))
+
 env_paths = [
-    Path(__file__).parent.parent / ".env",
+    PROJECT_ROOT / ".env",
     Path.cwd() / ".env",
 ]
 
@@ -29,11 +35,6 @@ for env_path in env_paths:
         load_dotenv(env_path)
         break
 
-TOKEN = os.getenv("DISCORD_TOKEN")
-if not TOKEN:
-    print("Error: DISCORD_TOKEN not found in .env file")
-    sys.exit(1)
-
 import discord
 
 from discord_py_self_mcp.cli_runtime import (
@@ -46,11 +47,11 @@ from discord_py_self_mcp.cli_runtime import (
 )
 from discord_py_self_mcp.logging_utils import log_to_stderr
 from discord_py_self_mcp.tool_utils import NON_MESSAGEABLE_TEXT, validate_message_content
-from discord_py_self_mcp.tools.embed import serialize_message
+from discord_py_self_mcp.tools.embed import serialize_attachment, serialize_message
 
-SCRIPT_DIR = Path(__file__).parent
 DAEMON_SCRIPT = SCRIPT_DIR / "daemon.py"
 CHECK_INTERVAL = 2
+MAX_ATTACHMENT_BYTES_DEFAULT = 10 * 1024 * 1024
 
 
 def _safe_unlink(path: Path) -> None:
@@ -74,6 +75,15 @@ def _load_or_create_auth_token() -> str:
     return token
 
 
+def _get_token_or_exit() -> str:
+    token = os.getenv("DISCORD_TOKEN")
+    if token:
+        return token
+
+    print("Error: DISCORD_TOKEN not found in .env file")
+    raise SystemExit(1)
+
+
 class DiscordDaemon:
     def __init__(self):
         self.client = discord.Client()
@@ -163,6 +173,7 @@ class DiscordDaemon:
 
     async def connect(self):
         """Connect to Discord and wait for the initial ready signal."""
+        token = _get_token_or_exit()
 
         @self.client.event
         async def on_ready():
@@ -173,7 +184,7 @@ class DiscordDaemon:
         async def on_disconnect():
             log_to_stderr(f"[{datetime.now()}] Disconnected from Discord")
 
-        asyncio.create_task(self.client.start(TOKEN))
+        asyncio.create_task(self.client.start(token))
         await asyncio.wait_for(self._connected.wait(), timeout=30)
 
     async def handle_command(self, command_data):
@@ -194,6 +205,14 @@ class DiscordDaemon:
                 return await self._send_message(
                     args.get("channel_id"), args.get("content")
                 )
+            if cmd == "get_message_attachments":
+                return await self._get_message_attachments(
+                    args.get("channel_id"),
+                    args.get("message_id"),
+                    args.get("attachment_index"),
+                    args.get("download_content", False),
+                    args.get("max_bytes", MAX_ATTACHMENT_BYTES_DEFAULT),
+                )
             if cmd == "list_threads":
                 return await self._list_threads(
                     args.get("channel_id"), args.get("archived", False)
@@ -310,6 +329,87 @@ class DiscordDaemon:
         message = await channel.send(content)
         return {"message_id": message.id, "success": True}
 
+    async def _get_message_attachments(
+        self,
+        channel_id,
+        message_id,
+        attachment_index=None,
+        download_content=False,
+        max_bytes=MAX_ATTACHMENT_BYTES_DEFAULT,
+    ):
+        channel = self.client.get_channel(channel_id) or await self.client.fetch_channel(
+            channel_id
+        )
+        if not channel:
+            return {"error": "Channel not found"}
+        if not isinstance(channel, discord.abc.Messageable):
+            return {"error": NON_MESSAGEABLE_TEXT}
+
+        try:
+            message = await channel.fetch_message(message_id)
+        except discord.NotFound:
+            return {"error": "Message not found"}
+        except discord.Forbidden:
+            return {"error": "Access denied to message"}
+
+        attachments = list(message.attachments)
+        if not attachments:
+            return {"error": "Message has no attachments"}
+
+        if attachment_index is not None:
+            if attachment_index < 0 or attachment_index >= len(attachments):
+                return {
+                    "error": (
+                        f"Attachment index {attachment_index} is out of range for "
+                        f"{len(attachments)} attachment(s)"
+                    )
+                }
+            indexed_attachments = [(attachment_index, attachments[attachment_index])]
+        else:
+            indexed_attachments = list(enumerate(attachments))
+
+        result = {
+            "message_id": message.id,
+            "attachments": [
+                {"index": index, **serialize_attachment(attachment)}
+                for index, attachment in indexed_attachments
+            ],
+        }
+
+        if not download_content:
+            return result
+
+        max_bytes = int(max_bytes)
+        downloads = []
+        skipped = []
+        for index, attachment in indexed_attachments:
+            if attachment.size is not None and attachment.size > max_bytes:
+                skipped.append(
+                    {
+                        "index": index,
+                        "filename": attachment.filename,
+                        "reason": f"size={attachment.size} exceeds max_bytes={max_bytes}",
+                    }
+                )
+                continue
+
+            blob = await attachment.read()
+            downloads.append(
+                {
+                    "index": index,
+                    "filename": attachment.filename,
+                    "content_type": attachment.content_type
+                    or "application/octet-stream",
+                    "content_base64": base64.b64encode(blob).decode("ascii"),
+                }
+            )
+
+        if downloads:
+            result["downloads"] = downloads
+        if skipped:
+            result["skipped"] = skipped
+        return result
+
     async def _list_threads(self, channel_id, archived=False):
         channel = self.client.get_channel(channel_id) or await self.client.fetch_channel(
             channel_id

package/scripts/dcli.py

@@ -6,6 +6,7 @@ Commands:
   daemon <start|stop|restart|status>  - Manage daemon process
   send-message --channel ID --content "msg"
   read-messages --channel ID [--limit N] [--after TIME]
+  get-message-attachments --channel ID --message ID [--attachment-index N] [--download --output-dir DIR]
   list-guilds
   list-channels --guild ID
   list-threads --channel ID [--archived]
@@ -28,6 +29,7 @@ Time formats for --after:
   1704067200            - Unix timestamp
 """
 
+import base64
 import json
 import os
 import socket
@@ -36,6 +38,11 @@ import sys
 import time
 from pathlib import Path
 
+SCRIPT_DIR = Path(__file__).resolve().parent
+PROJECT_ROOT = SCRIPT_DIR.parent
+if str(PROJECT_ROOT) not in sys.path:
+    sys.path.insert(0, str(PROJECT_ROOT))
+
 from discord_py_self_mcp.cli_runtime import AUTH_FILE, PID_FILE, SOCKET_PATH
 
 
@@ -70,8 +77,7 @@ def start_daemon():
     """Auto-start daemon if not running."""
     if not is_daemon_running():
         print("Starting daemon...")
-        script_dir = Path(__file__).parent
-        daemon_script = script_dir / "daemon.py"
+        daemon_script = SCRIPT_DIR / "daemon.py"
         subprocess.Popen(
             [sys.executable, str(daemon_script), "start"],
             stdout=subprocess.DEVNULL,
@@ -170,6 +176,74 @@ def format_messages(messages, reverse=True, use_local_timezone=True):
         print(f"[{created_at}] {author}: {content}")
 
 
+def print_attachment_metadata(attachments):
+    for attachment in attachments:
+        details = [
+            f"[Attachment {attachment.get('index', '?')}] {attachment.get('filename', 'unknown')}"
+        ]
+        if attachment.get("content_type"):
+            details.append(f"type={attachment['content_type']}")
+        if attachment.get("size") is not None:
+            details.append(f"size={attachment['size']}")
+        if attachment.get("width") and attachment.get("height"):
+            details.append(f"dimensions={attachment['width']}x{attachment['height']}")
+        if attachment.get("url"):
+            details.append(f"url={attachment['url']}")
+        print(" ".join(details))
+
+
+def cmd_get_message_attachments(
+    channel_id,
+    message_id,
+    attachment_index=None,
+    download=False,
+    output_dir=None,
+    max_bytes=None,
+):
+    if download and not output_dir:
+        print("Error: --output-dir is required when --download is used")
+        return
+
+    args = {"channel_id": channel_id, "message_id": message_id}
+    if attachment_index is not None:
+        args["attachment_index"] = attachment_index
+    if download:
+        args["download_content"] = True
+    if max_bytes is not None:
+        args["max_bytes"] = max_bytes
+
+    result = send_request({"command": "get_message_attachments", "args": args})
+    if "error" in result:
+        print(f"Error: {result['error']}")
+        return
+
+    attachments = result.get("attachments", [])
+    print(f"Found {len(attachments)} attachment(s) on message {result.get('message_id')}:")
+    print("-" * 60)
+    print_attachment_metadata(attachments)
+
+    skipped = result.get("skipped", [])
+    if skipped:
+        print("\nSkipped downloads:")
+        for item in skipped:
+            print(
+                f"  [Attachment {item.get('index', '?')}] {item.get('filename', 'unknown')}: {item.get('reason', 'Unknown reason')}"
+            )
+
+    downloads = result.get("downloads", [])
+    if not downloads:
+        return
+
+    output_path = Path(output_dir)
+    output_path.mkdir(parents=True, exist_ok=True)
+    print(f"\nSaved downloads to {output_path}:")
+    for item in downloads:
+        filename = item.get("filename") or f"attachment-{item.get('index', 'unknown')}"
+        destination = output_path / f"attachment-{item.get('index', 'unknown')}-{filename}"
+        destination.write_bytes(base64.b64decode(item["content_base64"]))
+        print(f"  {destination}")
+
+
 def cmd_send_message(channel_id, content):
     result = send_request(
         {
@@ -450,8 +524,7 @@ def cmd_create_thread(channel_id, name, message_id, content=None):
 
 
 def cmd_daemon(action):
-    script_dir = Path(__file__).parent
-    daemon_script = script_dir / "daemon.py"
+    daemon_script = SCRIPT_DIR / "daemon.py"
 
     if action == "start":
         if is_daemon_running():
@@ -487,6 +560,16 @@ def main():
     read_parser.add_argument("--limit", "-l", type=int, default=10, help="Number of messages")
     read_parser.add_argument("--after", "-a", type=str, help="Only show messages after this time (e.g. '4h', '30m', '2024-01-01T00:00:00')")
 
+    attachments_parser = subparsers.add_parser(
+        "get-message-attachments", help="Show attachment metadata for a message"
+    )
+    attachments_parser.add_argument("--channel", "-c", required=True, type=int, help="Channel ID")
+    attachments_parser.add_argument("--message", "-m", required=True, type=int, help="Message ID")
+    attachments_parser.add_argument("--attachment-index", type=int, help="Optional zero-based attachment index")
+    attachments_parser.add_argument("--download", action="store_true", help="Download selected attachments to disk")
+    attachments_parser.add_argument("--output-dir", type=str, help="Directory to write downloads into when --download is used")
+    attachments_parser.add_argument("--max-bytes", type=int, help="Skip downloads larger than this many bytes")
+
     subparsers.add_parser("list-guilds", help="List all guilds")
 
     channels_parser = subparsers.add_parser("list-channels", help="List channels in a guild")
@@ -555,6 +638,15 @@ def main():
         cmd_send_message(args.channel, args.content)
     elif args.command == "read-messages":
         cmd_read_messages(args.channel, args.limit, args.after)
+    elif args.command == "get-message-attachments":
+        cmd_get_message_attachments(
+            args.channel,
+            args.message,
+            args.attachment_index,
+            args.download,
+            args.output_dir,
+            args.max_bytes,
+        )
     elif args.command == "list-guilds":
         cmd_list_guilds()
     elif args.command == "list-channels":

package/server.json

@@ -6,14 +6,14 @@
     "url": "https://github.com/Microck/discord.py-self-mcp",
     "source": "github"
   },
-  "version": "1.2.7",
+  "version": "1.3.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "discord-selfbot-mcp",
       "runtimeHint": "python",
-      "version": "1.2.7",
+      "version": "1.3.0",
       "packageArguments": [],
       "environmentVariables": [
         {
@@ -38,7 +38,7 @@
         },
         {
           "name": "DISCRAWL_BIN",
-          "description": "Optional path to discrawl executable for the run_discrawl MCP tool. Overrides the default preference for ../discrawl-self/bin/discrawl.",
+          "description": "Optional path to discrawl executable for the run_discrawl MCP tool. Overrides the default Microck fork path at ../discrawl-self/bin/discrawl.",
           "format": "string",
           "isRequired": false
         }