adf-mcp-server

面向 Azure Data Factory 监控和根因分析的只读 MCP（Model Context Protocol）服务器，为从 VS Code / Claude Code 使用而构建。

状态：第 1 步（骨架 + 健康检查）。 目前还没有 Azure 连接——那将在第 2 步（身份验证）和第 3 步（ADF 工具）中添加。

环境要求

• 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_* 行是第 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 工具——它应该返回 {"status": "ok", ...}，完全不接触 Azure。

运行测试

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

项目结构

参见 src/adf_mcp/——server.py（MCP 传输）、config.py（设置）、logging_config.py（结构化日志）。从第 3 步开始，领域逻辑和 Azure 连接会添加到 src/adf_mcp/domain/ 下。

疑难解答

• 客户端立即显示“server disconnected”：先单独确认 python -m adf_mcp.server 能否正常运行——如果在客户端连接前发生启动异常，进程会直接被杀死。

• 客户端无法解析响应 / 输出乱码：有某些内容写入了 stdout，而不是 MCP 协议本身（例如多出的 print()）。这个项目中的所有日志都写入 stderr，正是出于这个原因。