AB Download Manager MCP Server (abdm-mcp)

MCP server for AB Download Manager. Connects AI coding assistants and autonomous agents (Claude Desktop, OpenAI Codex & ChatGPT, Google Antigravity, Kimi, Cursor, Windsurf, Cline, Zed) to ABDM so they can offload large downloads—model weights, datasets, and archives—with multi-threaded acceleration (up to 32 connections), pause/resume, and queueing instead of choking on single-threaded agent HTTP calls.

Quick Start

Run with uvx (No installation needed)

uvx abdm-mcp

Network Transports (SSE & HTTP)

# Run with Server-Sent Events (SSE) for remote/containerized agents
uvx abdm-mcp --transport sse --port 8000

# Run with Streamable HTTP
uvx abdm-mcp --transport streamable-http --port 8000

Install with pip

pip install abdm-mcp
python -m abdm_mcp

Agent Configuration

abdm-mcp complies with the Model Context Protocol standard and works across all major AI coding agents, IDEs, and assistant platforms.

1. Claude Desktop

Add to your claude_desktop_config.json:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "abdm": {
      "command": "uvx",
      "args": ["abdm-mcp"],
      "env": {
        "ABDM_MCP_DEFAULT_MODE": "interactive",
        "ABDM_API_KEY": "your_api_key_if_configured"
      }
    }
  }
}

2. OpenAI Codex & ChatGPT Desktop

Add to ~/.codex/config.toml (global) or .codex/config.toml (project-scoped):

[mcp_servers.abdm]
command = "uvx"
args = ["abdm-mcp"]
env = { "ABDM_MCP_DEFAULT_MODE" = "headless" }

Or add via the Codex CLI:

codex mcp add abdm -- uvx abdm-mcp

3. Google Antigravity

Add to your workspace or user mcp.json:

{
  "mcpServers": {
    "abdm": {
      "command": "uvx",
      "args": ["abdm-mcp"]
    }
  }
}

4. Kimi (Moonshot AI / Kimi CLI)

Add to your Kimi Agent configuration (kimi_mcp.json or agent settings):

{
  "mcpServers": {
    "abdm": {
      "command": "uvx",
      "args": ["abdm-mcp"],
      "env": {
        "ABDM_MCP_DEFAULT_MODE": "headless"
      }
    }
  }
}

5. Cursor

Add to your project's .cursor/mcp.json or Cursor Settings > Features > MCP:

{
  "mcpServers": {
    "abdm": {
      "command": "uvx",
      "args": ["abdm-mcp"]
    }
  }
}

6. Windsurf (Codeium)

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "abdm": {
      "command": "uvx",
      "args": ["abdm-mcp"]
    }
  }
}

7. Cline & Roo Code (VS Code)

Open Settings in Cline / Roo Code and add under MCP Servers:

{
  "mcpServers": {
    "abdm": {
      "command": "uvx",
      "args": ["abdm-mcp"]
    }
  }
}

8. Zed Editor

Add to ~/.config/zed/settings.json:

{
  "context_servers": {
    "abdm": {
      "command": {
        "env": {},
        "path": "uvx",
        "args": ["abdm-mcp"]
      }
    }
  }
}

9. Continue.dev

Add to ~/.continue/config.json:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "uvx",
          "args": ["abdm-mcp"]
        }
      }
    ]
  }
}

10. Goose (Block)

Run the extension add command or add to ~/.config/goose/config.yaml:

goose configure add-extension --name abdm --command uvx --args abdm-mcp

Tool Surface & Capabilities

All tools return strongly-typed Pydantic schemas and include explicit MCP Tool Annotations:

Security & Sandboxing Guardrails

Autonomous agents are powerful, but should not have unrestricted filesystem or network write access. abdm-mcp implements defense-in-depth:

1. Path Sandboxing: By default, headless downloads are strictly confined to ~/Downloads/ABDM. Path traversal escapes (../) and absolute paths outside allowed roots are rejected.

2. Private-Network URL Guard: Protects against SSRF by rejecting direct requests to localhost, 127.0.0.0/8, ::1, RFC1918 LAN subnets (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16), and link-local metadata endpoints (169.254.169.254).

3. Filename Sanitization: Rejects slashes, drive prefixes, control characters, and reserved Windows device names (CON, PRN, AUX, NUL, etc.).

4. Header Protection: Blocks sensitive headers (Cookie, Authorization, Proxy-Authorization, Host) by default to prevent credential leakage.

5. Safe Subprocess Execution: The CLI backend strictly uses asyncio.create_subprocess_exec (never shell=True) with bounded streaming readers (1MB limit) and hard execution timeouts.

Environment Variables

Development & Testing

# Clone the repository
git clone https://github.com/shivamtawari/ab-download-manager-mcp.git
cd ab-download-manager-mcp

# Install dependencies with uv
uv sync --all-groups

# Run full test suite
uv run pytest tests/

# Run linting
uv run ruff check .

License

MIT License. See LICENSE for details.