adf-mcp-server

Azure Data Factory の監視と根本原因分析を行うための読み取り専用 MCP (Model Context Protocol) サーバーです。VS Code / Claude Code から使用するために構築されています。

ステータス: Step 1 (スケルトン + ヘルスチェック)。 まだ Azure との接続はありません。これは Step 2 (auth) と Step 3 (ADF tools) で追加されます。

要件

• Python 3.11+

Related MCP server: azure-adf-mcp

ローカルセットアップ

cd adf-mcp-server
python -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate
pip install -e ".[dev]"
cp .env.example .env

現時点では .env に必要なのはサーバー設定ブロック (ADF_MCP_*) だけです。AZURE_* の行は Step 2 用のプレースホルダーなので、今はコメントアウトしたままにしてください。

サーバーの実行

python -m adf_mcp.server
# or, after `pip install -e .`:
adf-mcp-server

サーバーは stdio を介して通信します。ターミナルで直接実行するとハングしているように見えますが、これは想定どおりです。MCP クライアント (VS Code 拡張機能、Claude Code、mcp dev など) が stdin/stdout 経由で接続するのを待っています。

VS Code での設定

MCP 対応拡張機能のサーバー設定には、次を指定してください:

{
  "command": "python",
  "args": ["-m", "adf_mcp.server"],
  "cwd": "/absolute/path/to/adf-mcp-server"
}

接続したら、health_check ツールを呼び出してください。Azure に一切触れることなく、{"status": "ok", ...} を返すはずです。

テストの実行

pip install -e ".[dev]" pytest-asyncio
pytest -v

プロジェクト構成

src/adf_mcp/ を参照してください。server.py (MCP トランスポート)、config.py (設定)、logging_config.py (構造化ログ) が含まれます。ドメインロジックと Azure 接続は、Step 3 以降に src/adf_mcp/domain/ 配下に追加されます。

トラブルシューティング

src/adf_mcp/ を参照してください。server.py (MCP トランスポート)、config.py (設定)、logging_config.py (構造化ログ) が含まれます。ドメインロジックと Azure 接続は、Step 3 以降に src/adf_mcp/domain/ 配下に追加されます。

• クライアントに "server disconnected" と表示される場合: まず python -m adf_mcp.server が単体で正常に実行されることを確認してください。起動時の例外が発生すると、クライアントが接続する前にプロセスが終了してしまうためです。

• クライアントが応答を解析できない、または出力が文字化けする場合: MCP プロトコル以外の何か (例: 紛れ込んだ print()) が stdout に書き込まれています。このプロジェクトのすべてのログが stderr に出力されるのは、まさにこのためです。