Fabric REST API服务

mcp织物架

用于Microsoft Fabric REST API的MCP服务器，主要用于Visual Studio Code和Codex。

概述

服务器公开了一个REST接口，该接口充当Microsoft Cloud Partner（MCP）服务和Fabric之间的桥梁。它旨在成为一个轻量级的后端，Visual Studio Code扩展和其他工具可以在开发过程中与之交互。

需求

• Python 3.11
• 诗歌 用于依赖关系管理

设置

1. 安装依赖项：
   复制

   poetry install
   

   如果无法访问互联网，请运行 install_offline.ps1 相反。 详细步骤见 CODEX_SETUP.md.
2. 通过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工作流，该工作流对每个拉取请求执行相同的命令，以确保服务器保持稳定。