English Français العربية

Marzban MCP

Registre officiel IA et agents

Manage Marzban panels through the Model Context Protocol.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package marzban-mcp
Claude Code 
claude mcp add marzban-mcp -e 'MARZBAN_BASE_URL=<MARZBAN_BASE_URL>' -e 'MARZBAN_USERNAME=<MARZBAN_USERNAME>' -e 'MARZBAN_PASSWORD=<your marzban_password>' -- npx -y marzban-mcp@0.4.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "marzban-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "marzban-mcp@0.4.0"
            ],
            "env": {
                "MARZBAN_BASE_URL": "<MARZBAN_BASE_URL>",
                "MARZBAN_USERNAME": "<MARZBAN_USERNAME>",
                "MARZBAN_PASSWORD": "<your marzban_password>"
            }
        }
    }
}

Variables d'environnement

  • MARZBAN_BASE_URL obligatoire URL of the Marzban panel.
  • MARZBAN_USERNAME obligatoire Marzban administrator username.
  • MARZBAN_PASSWORD obligatoire secret Marzban administrator password.
OCI package docker.io/ilmar7786/marzban-mcp:0.4.0
Claude Code 
claude mcp add marzban-mcp -e 'MARZBAN_BASE_URL=<MARZBAN_BASE_URL>' -e 'MARZBAN_USERNAME=<MARZBAN_USERNAME>' -e 'MARZBAN_PASSWORD=<your marzban_password>' -- docker run -i --rm docker.io/ilmar7786/marzban-mcp:0.4.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "marzban-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/ilmar7786/marzban-mcp:0.4.0"
            ],
            "env": {
                "MARZBAN_BASE_URL": "<MARZBAN_BASE_URL>",
                "MARZBAN_USERNAME": "<MARZBAN_USERNAME>",
                "MARZBAN_PASSWORD": "<your marzban_password>"
            }
        }
    }
}

Variables d'environnement

  • MARZBAN_BASE_URL obligatoire URL of the Marzban panel.
  • MARZBAN_USERNAME obligatoire Marzban administrator username.
  • MARZBAN_PASSWORD obligatoire secret Marzban administrator password.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. MarzbanSDK
  2. How it fits together
  3. Packages
  4. Documentation
  5. Contributing
  6. License

MarzbanSDK

A TypeScript toolkit for the Marzban API.

**Documentation** · **SDK** · **MCP Server**

One TypeScript SDK for Marzban, and everything built on top of it. Fix a bug or add an endpoint in the SDK, and the MCP server, the CLI, and every app built on it get it for free.

How it fits together

flowchart LR
    Panel(["Marzban Panel"])
    SDK["marzban-sdk"]
    MCP["marzban-mcp<br/>MCP server"]
    CLI["marzban-cli<br/>CLI · WIP"]
    App["Your app<br/>Node · Bun · Deno · Browser"]
    Agents(["Claude · Cursor · any MCP client"])

    Panel <--> SDK
    SDK --> MCP --> Agents
    SDK --> CLI
    SDK --> App

The SDK talks to your Marzban panel. The MCP server and CLI are just clients of that same SDK — same auth, same retries, same typed errors — so they never drift from each other or from your own code.

Packages

PackagenpmDockerWhat it is
packages/sdkmarzban-sdk—The TypeScript SDK — auth, retries, resilient WebSocket reconnects, webhooks, lifecycle
packages/mcpmarzban-mcpilmar7786/marzban-mcpAn MCP server exposing Marzban operations as tools for AI agents
packages/cli——A CLI on top of the SDK — WIP, unpublished
apps/docs——The documentation site

Each publishable package has its own version, README.md, changelog and release tags (sdk-v*, mcp-v*, cli-v*).

Documentation

Full guides, configuration reference and the complete typed API live at ilmar7786.github.io/marzban-sdk.

For how the repository itself is built — architecture, conventions, testing, CI and releases — see docs/.

Contributing

Contributions are welcome — see CONTRIBUTING.md for how to submit a patch. Found a bug or have an idea? Open an issue.

License

MIT © ilmar7786

If this project saves you time, consider giving it a ⭐ on GitHub.

Questions fréquentes

Qu'est-ce que Marzban MCP ?

Manage Marzban panels through the Model Context Protocol.

Comment installer Marzban MCP ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add marzban-mcp -e 'MARZBAN_BASE_URL=<MARZBAN_BASE_URL>' -e 'MARZBAN_USERNAME=<MARZBAN_USERNAME>' -e 'MARZBAN_PASSWORD=<your marzban_password>' -- npx -y marzban-mcp@0.4.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Marzban MCP ?

Oui. Il attend MARZBAN_BASE_URL, MARZBAN_USERNAME, MARZBAN_PASSWORD, à renseigner dans sa configuration.

Marzban MCP est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Marzban MCP ?

Il est publié par Ilmar7786. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.