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 分