airflow-mcp-server

by abhishekbhakat
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

airflow-mcp-server: Airflowを制御するためのMCPサーバー

Glamaで検索

概要

Airflow API を介して Airflow を制御するためのモデル コンテキスト プロトコルサーバー。

デモビデオ

https://github.com/user-attachments/assets/f3e60fff-8680-4dd9-b08e-fa7db655a705

設定

Claude Desktopでの使用

{ "mcpServers": { "airflow-mcp-server": { "command": "uvx", "args": [ "airflow-mcp-server" ], "env": { "AIRFLOW_BASE_URL": "http://<host:port>/api/v1", // Either use AUTH_TOKEN for basic auth "AUTH_TOKEN": "<base64_encoded_username_password>", // Or use COOKIE for cookie-based auth "COOKIE": "<session_cookie>" } } } }

動作モード

サーバーは次の 2 つの動作モードをサポートしています。

  • セーフモード( --safe ): 読み取り専用操作 (GET リクエスト) のみを許可します。Airflow インスタンスへの変更を一切防止したい場合に便利です。
  • アンセーフモード( --unsafe ): 変更を含むすべての操作を許可します。これがデフォルトのモードです。

セーフモードで起動するには:

airflow-mcp-server --safe

明示的に非安全モードで起動するには(ただし、これはデフォルトです):

airflow-mcp-server --unsafe

考慮事項

MCP サーバーでは、環境変数が設定されている必要があります。

  • AIRFLOW_BASE_URL : Airflow APIのベースURL
  • AUTH_TOKEN : 基本認証に使用するトークン(これはbase64でエンコードされたユーザー名:パスワードである必要があります)( COOKIEが提供されている場合はオプション
  • COOKIE : 認証に使用するセッションCookie( AUTH_TOKENが指定されている場合はオプション
  • OPENAPI_SPEC : OpenAPI 仕様ファイルへのパス (オプション) (デフォルトは最新の安定リリース)

認証

サーバーは次の 2 つの認証方法をサポートしています。

  • 基本認証: AUTH_TOKEN環境変数経由でbase64エンコードされたユーザー名:パスワードを使用する
  • Cookie : COOKIE環境変数経由でセッションCookieを使用する

これらの認証方法の少なくとも 1 つを指定する必要があります。

ページ制限

デフォルトは 100 項目ですが、 airflow.cfgファイルの [api] セクションにあるmaximum_page_limitオプションを使用して変更できます。

タスク

  • [x] 最初のAPI
  • [x] OpenAPI仕様を解析する
  • [x] セーフ/アンセーフモードの実装
  • [x] セッション認証を許可する
  • [ ] list_toolsを使用して適切な説明を解析します。
  • [ ] Airflow 設定の取得(ページ制限用
  • [ ] 環境変数はオプションです(環境変数はAirflowプラグインには適さない可能性があります
ID: 6gjq9w80xr