mcpField
M
Marzban MCP

Marzban MCP

ローカル
github.com/Ilmar7786クラウド・インフラ261 週間前に更新
リポジトリ

Marzban MCP について

Marzban MCPは、Marzbanパネルを管理するTypeScript製MCPサーバーです。MarzbanSDKを関連ツールと共有し、認証やAPIの挙動を共通化しています。

主な機能

  1. 01Marzbanパネル操作の管理
  2. 02Marzban TypeScript SDKを基盤に構築
  3. 03認証とリトライ動作の共有

活用シーン

  1. 01AIエージェントからMarzbanパネルを管理
  2. 02MCPクライアント経由でMarzbanを操作

MCP 対応

Marzbanの操作をツールとして、AIエージェントなどのMCPクライアントに提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "ilmar7786-marzban": {
      "command": "npx",
      "args": [
        "-y",
        "marzban-mcp"
      ],
      "env": {
        "MARZBAN_BASE_URL": "<MARZBAN_BASE_URL>",
        "MARZBAN_USERNAME": "<MARZBAN_USERNAME>",
        "MARZBAN_PASSWORD": "<MARZBAN_PASSWORD>"
      }
    }
  }
}
起動コマンドnpx -y marzban-mcp
設定が必要な環境変数
MARZBAN_BASE_URLURL of the Marzban panel.
MARZBAN_USERNAMEMarzban administrator username.
MARZBAN_PASSWORDシークレットMarzban administrator password.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmmarzban-mcp0.4.0
ocidocker.io/ilmar7786/marzban-mcp:0.4.0

ツール

15

掲載時のツール一覧 · 1 週間前に更新

パラメーター型必須説明
sectionstringいいえ概要ではなく、このトップレベルキーの生 JSON を返します（例："inbounds"、"routing"）。設定全体を取得するには "raw" を使用します。省略すると構造化された概要が返されます。完全な JSON が必要な場合を除き、"raw" より概要を優先してください。

詳細

MarzbanSDK

MarzbanSDK

Marzban API 向けの TypeScript ツールキット。

CI license

ドキュメント · SDK · MCP サーバー

Marzban 向けの単一の TypeScript SDK と、その上に構築されたすべてのものです。SDK でバグを修正したりエンドポイントを追加したりすれば、MCP サーバー、CLI、およびその上に構築されたすべてのアプリがそれをそのまま利用できます。

全体の構成

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

SDK はお使いの Marzban パネルと通信します。MCP サーバーと CLI は、この同じ SDK の単なるクライアントです。認証も、リトライも、型付きエラーも同じなので、互いに、あるいはお客様自身のコードから乖離することはありません。

パッケージ

パッケージnpmDocker内容
packages/sdkmarzban-sdk—TypeScript SDK — 認証、リトライ、堅牢な WebSocket 再接続、Webhook、ライフサイクル
packages/mcpmarzban-mcpilmar7786/marzban-mcpMarzban の操作を AI エージェント向けのツールとして公開する MCP サーバー
packages/cli——SDK の上に構築された CLI — 開発中、未公開
apps/docs——ドキュメントサイト

公開対象の各パッケージには、それぞれ独自のバージョン、README.md、変更履歴、リリースタグ (sdk-v*、mcp-v*、cli-v*) があります。

ドキュメント

完全なガイド、設定リファレンス、および型付き API の全体は ilmar7786.github.io/marzban-sdk にあります。

リポジトリ自体がどのように構築されているか — アーキテクチャ、規約、テスト、CI、リリース — については docs/ をご覧ください。

コントリビューション

コントリビューションを歓迎します。パッチの提出方法については CONTRIBUTING.md をご覧ください。バグを見つけた、あるいはアイデアがありますか? Issue を作成してください。

ライセンス

MIT © ilmar7786

このプロジェクトがお役に立ったなら、GitHub で ⭐ を付けていただけると嬉しいです。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。