mcp织物架
用于Microsoft Fabric REST API的MCP服务器,主要用于Visual Studio Code和Codex。
概述
服务器公开了一个REST接口,该接口充当Microsoft Cloud Partner(MCP)服务和Fabric之间的桥梁。它旨在成为一个轻量级的后端,Visual Studio Code扩展和其他工具可以在开发过程中与之交互。
需求
- Python 3.11
- 诗歌 用于依赖关系管理
设置
- 安装依赖项:
poetry install如果无法访问互联网,请运行 install_offline.ps1 相反。 详细步骤见 CODEX_SETUP.md.
- 通过STDIO启动服务器:
poetry run python -m mcp_fabric.main --stdio
poetry run python -m mcp_fabric.main --stdio --rest --host 0.0.0.0启用REST后,服务将继续监听 http://localhost:3000 默认情况下。 使用 --host 和 --port 更改绑定地址。
认证
服务器支持两种身份验证模式:
- 管理身份 –在Azure内部运行时使用分配给主机的标识。
- 服务主体 –指定
AZURE_CLIENT_ID,AZURE_TENANT_ID和AZURE_CLIENT_SECRET环境变量。
这些选项的配置通常通过环境变量或配置文件提供。
REST端点
GET /health–部署或工具使用的健康检查端点。GET /v1/workspaces–列出呼叫者可访问的结构工作区。POST /v1/workspaces–创建一个新的工作区。GET /v1/artifacts–列出工件(数据集、报告、笔记本等)。POST /v1/artifacts–在工作空间内创建工件。
这些端点是一个起点,可以随着服务器的发展而扩展。
测试
使用以下命令运行单元测试 pytest:
poetry run pytest该项目包括一个CI工作流,该工作流对每个拉取请求执行相同的命令,以确保服务器保持稳定。
