Marzban MCP

io.github.Ilmar7786由 GitHub 帳號 Ilmar7786 發布v0.4.0更新於 Oct 24, 2026

Manage Marzban panels through the Model Context Protocol.

已驗證STDIO僅桌面雲端與基礎設施安全與監控

概覽

AI 產生的概覽

本機 MCP 伺服器，將 Marzban 面板操作包裝成工具，讓 AI 助理管理 Marzban 面板。

可以做什麼
  • 把 Marzban 面板操作以工具形式提供給 AI 代理，底層使用 marzban-sdk 這個 TypeScript 用戶端。
  • 透過 Model Context Protocol 管理 Marzban 面板，沿用 SDK 的驗證、重試與型別化錯誤處理。
  • 以 stdio 在本機執行，可用 npx 執行 npm 套件，也可執行 Docker 映像。
  • 清單未列出個別工具，因此這裡無法說明確切的可用操作集合。
適用情境
適合自行維運 Marzban 面板，並希望助理在 Claude、Cursor 等 MCP 用戶端中直接完成面板管理操作，而不必手動操作面板介面或 API 的情境。
執行需求
以 stdio 本機程序執行，可透過 npx（npm 套件 marzban-mcp）或 Docker 映像 ilmar7786/marzban-mcp 啟動。需要環境變數 MARZBAN_BASE_URL（面板網址）、MARZBAN_USERNAME 與 MARZBAN_PASSWORD（管理員憑證），以及連線到該面板的網路。
安裝前請注意
伺服器需要在其環境中提供 Marzban 管理員憑證（MARZBAN_USERNAME 與 MARZBAN_PASSWORD），請妥善保管。它操作的是實際面板，助理的操作可能建立、修改或刪除使用者及其他面板資料。清單未列出工具，接上正式環境面板前應先確認其能力範圍。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Marzban MCP，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[MarzbanSDK]

MarzbanSDK

A TypeScript toolkit for the Marzban API.

[CI] [license]

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

mermaid
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.

來源：README.md，提交 4318c88

工具

0
SourceWeft 曾在隔離沙箱中以無憑證方式啟動該軟體包一次，以列出其工具，但未能完成：伺服器未能啟動。

版本歷史

2
  1. v0.4.0最新Oct 21, 2026
  2. v0.3.0Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分