Fabric RTI MCP

官方

为 Microsoft Fabric 实时智能提供 KQL 查询、事件流管理和实时警报

分类: 其他第 38 / 230
Stars: ★ 131 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Python 3.10+ · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 17 天前
工具数: 39

65FMRS · C

该服务器是微软官方维护的 MCP 服务器，用于将 AI 代理连接到 Fabric RTI，提供广泛的工具集，包括 KQL 查询、事件流管理和地图操作。它提供了自然语言界面，并获得了良好的文档支持。但是，它处于预览阶段，并需要仔细的权限管理以安全使用。

最强项 · 文档质量 15/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

13/20

维护活跃度

15/20

文档质量

15/20

安装易用性

12/20

查看各项评分依据

可靠性 10/20: 仓库包含用于服务器关键路径的测试（测试文件存在但未审查），以及CI工作流（未提供具体文件，但存在活跃的GitHub仓库）。清单和README显示了结构的工具列表，但静态审查无法验证工具是否完全匹配行为。没有证据表明服务器初始化失败，因此10分是合理的。
安全与权限 13/20: 使用Azure Identity进行凭据处理，不存储令牌。HTTP模式有bearer令牌检查和OBO支持。通过RBAC进行工具级限制。未看到危险的删除、部署或付款的默认确认，但README提到了对破坏性操作的保护措施。没有发现红色标志。安全评分为13分，因为确认机制未在部署中标准化，HTTP模式需要明确的安全边界。
维护活跃度 15/20: 活跃的仓库，有近期提交和15分反映了持续维护。LICENSE存在，具有清晰的Microsoft CLA和贡献指南。此评分基于仓库活动未验证提交日期，但仓库状态显示未归档。
文档质量 15/20: README提供广泛文档，涵盖安装、配置、身份验证、环境变量、示例提示词和调试。没有明确的故障排除部分，但文档总体详尽。评分15分，反映出少量不足，如缺少专门的支持渠道或更清晰的安全指南。
安装易用性 12/20: 提供了多种安装方法（uvx、pip、源代码）。包含VS Code配置示例。步骤明确，但依赖uv，某些用户可能认为复杂。评分12分，因为未验证执行，且设置需要多个步骤。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据连接数据库

适合谁

使用 Microsoft Fabric RTI 并希望通过 AI 代理以自然语言交互查询数据的团队。
需要快速分析流式数据并自动生成 KQL 查询的数据工程师。
希望自动化实时数据监控和警报（如 Activator 触发器和事件流管理）的开发人员。
需要可视化地理空间数据并与地图项交互的分析师。

不适合谁

需要生产级、已验证的 MCP 服务器（当前为公共预览版）的部署。
不熟悉 Fabric RTI 或 KQL 的用户，因为服务器依赖现有知识来有效使用。
不希望向 LLM 或第三方客户端暴露其数据或工作区的组织。
需要 HTTP 模式高级安全性而无需额外配置的用例。

所需权限

访问 Microsoft Fabric 工作区，包括 Eventhouse、Eventstreams、Activator 和 Map 项目。
执行 KQL 查询和管理命令，包括摄取数据和修改架构。
创建、更新和删除 Eventstreams 和 Map 项。
创建 Activator 触发器并配置电子邮件或 Teams 通知。
使用 Azure Identity 进行身份验证，自动使用环境凭据、Azure CLI、PowerShell 等。

风险与副作用

公共预览版：实现可能会在正式发布前发生重大变化。
MCP 客户端可以执行破坏性操作（如删除 Eventstreams 或地图）权限可能过大。
与第三方 LLM 或客户端共享数据可能超出 Fabric 合规性边界，需仔细审查。
HTTP 模式可能暴露在非本地环境，需确保在其前设置适当的安全边界（如 Entra 认证）。
某些工具（如 kusto_get_shots）需要额外配置（如嵌入端点和表）。

安装接入

准备工作

运行环境：Python 3.10+ · 远程托管（无需本地环境）

其他可选配置项（27 个）

KUSTO_SERVICE_URI 可选 Kusto 集群的默认 URI，例如 https://help.kusto.windows.net/，可在 Azure Data Explorer 群集页获取。

KUSTO_SERVICE_DEFAULT_DB 可选 Kusto 查询的默认数据库名，例如 Samples。

FABRIC_API_BASE 可选 Microsoft Fabric API 的基础 URL，默认 https://api.fabric.microsoft.com/v1。

AZ_OPENAI_EMBEDDING_ENDPOINT 可选 kusto_get_shots 使用 AOAI 嵌入时所需的 Azure OpenAI 端点，含部署名和 api-version。

KUSTO_KNOWN_SERVICES 可选预配置 Kusto 服务的 JSON 数组。

KUSTO_EAGER_CONNECT 可选是否在启动时立即连接默认服务，默认 false。

KUSTO_ALLOW_UNKNOWN_SERVICES 可选是否允许连接未列入已知服务列表的服务。

KUSTO_SHOTS_TABLE 可选启用 kusto_get_shots 并指定默认 shots 表。

KUSTO_SHOTS_EMBEDDING_METHOD 可选 kusto_get_shots 默认嵌入方法（slm 或 aoai）。

KUSTO_SHOTS_SLM_MODEL 可选 kusto_get_shots 默认 SLM 模型，默认 harrier-v1-270m。

FABRIC_BASE_URL 可选 Microsoft Fabric Web 界面的基础 URL。

FABRIC_RTI_ALLOWED_TOOLS 可选逗号分隔的服务名或完整工具名，用于限定可暴露的工具。

FABRIC_RTI_KUSTO_DEEPLINK_STYLE 可选覆盖 deeplink 样式自动检测（adx 或 fabric）。

FABRIC_RTI_TRANSPORT 可选服务器传输模式，默认 stdio，可选 http。

FABRIC_RTI_HTTP_HOST 可选 HTTP 服务器主机地址，默认 127.0.0.1。

FABRIC_RTI_HTTP_PORT 可选 HTTP 服务器端口，默认 3000。

FABRIC_RTI_HTTP_PATH 可选 MCP 端点的 HTTP 路径，默认 /mcp。

FABRIC_RTI_STATELESS_HTTP 可选是否使用无状态 HTTP 模式。

FABRIC_RTI_HTTP_ALLOW_MI 可选允许无 bearer 的请求使用托管标识，仅限受信边界内。

FABRIC_RTI_HTTP_DEBUG_MODE 可选本地 HTTP 测试模式，允许本地凭据和宽松 CORS，勿在生产使用。

FABRIC_RTI_HTTP_ALLOWED_HOSTS 可选 HTTP DNS 重绑定防护的主机允许列表。

FABRIC_RTI_HTTP_ALLOWED_ORIGINS 可选 HTTP DNS 重绑定防护的来源允许列表。

FABRIC_RTI_CORS_ORIGINS 可选 CORS 允许来源，未设置时使用回环地址。

FABRIC_RTI_KUSTO_KNOWN_SERVICES_PROBE 可选 kusto_known_services 的探测策略（auto、always、never）。

USE_OBO_FLOW 可选启用 OBO 令牌交换流程。

FABRIC_RTI_MCP_AZURE_TENANT_ID 可选 Azure AD 租户 ID。

FABRIC_RTI_MCP_USER_MANAGED_IDENTITY_CLIENT_ID 可选用户托管标识的客户端 ID。

通过 PyPI 安装：

确保已安装 UV 和 VS Code。
打开 VS Code，按 Ctrl+Shift+P 打开命令面板。
运行命令 MCP: Add Server，选择“Install from Pip”。
输入包名 microsoft-fabric-rti-mcp 并按照提示完成安装。
在 settings.json 或 mcp.json 中添加配置，例如使用 uvx 命令。

或者，如果已启用 GitHub Copilot CLI，可以在会话中运行 /mcp add 并选择包。

MCP 配置 · JSON

{
  "mcpServers": {
    "fabric-rti-mcp": {
      "command": "uvx",
      "args": [
        "microsoft-fabric-rti-mcp"
      ],
      "env": {
        "KUSTO_SERVICE_URI": "https://help.kusto.windows.net/",
        "KUSTO_SERVICE_DEFAULT_DB": "Samples",
        "FABRIC_API_BASE": "https://api.fabric.microsoft.com/v1"
      }
    }
  }
}

适用于使用 mcpServers 字段的客户端。VS Code 等使用其他字段的客户端，可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "fabric-rti-mcp": {
      "command": "uvx",
      "args": [
        "microsoft-fabric-rti-mcp"
      ],
      "env": {
        "KUSTO_SERVICE_URI": "https://help.kusto.windows.net/",
        "KUSTO_SERVICE_DEFAULT_DB": "Samples",
        "FABRIC_API_BASE": "https://api.fabric.microsoft.com/v1"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add fabric-rti-mcp -e KUSTO_SERVICE_URI=https://help.kusto.windows.net/ -e KUSTO_SERVICE_DEFAULT_DB=Samples -e FABRIC_API_BASE=https://api.fabric.microsoft.com/v1 -- uvx microsoft-fabric-rti-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

使用 uvx microsoft-fabric-rti-mcp 安装后重启 MCP 客户端，确认工具列表中出现 kusto_query、eventstream_list 等 Fabric RTI 工具；尝试提示“列出我的 Kusto 表”，若能正常返回即证明连接成功。

常见排障

检查身份验证：确保已通过 Azure CLI、Visual Studio、Azure PowerShell 或浏览器登录，并具有访问权限。
检查环境变量：验证 KUSTO_SERVICE_URI 和 KUSTO_SERVICE_DEFAULT_DB 是否正确设置。
检查权限：为用户分配所需的 Fabric RBAC 角色，以执行查询、创建或删除操作。
检查网络：确保客户端可以访问 Fabric 和 Azure Data Explorer 端点。
对于远程部署，验证 HTTP 模式的配置（如 FABRIC_RTI_HTTP_PORT）和身份验证令牌。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我的 Eventhouse 中的数据库
从 StormEvents 表中抽取 10 行示例数据
列出我工作区中的所有 Eventstreams
使用 StormEvents 表，当伊利诺伊州发生洪水时通过电子邮件通知我

工具能力 39

kusto_known_services 只读

列出 MCP 中配置的所有可用 Kusto 服务。

kusto_query 只读

在指定数据库上执行 KQL 查询。

kusto_command 写入

执行 Kusto 管理命令（如 .show、.create、.alter、.drop）。

kusto_list_entities 只读

列出集群或数据库中的实体（数据库、表、外部表、物化视图、函数、图）。

kusto_describe_database 只读

获取数据库中所有实体的架构信息。

kusto_describe_database_entity 只读

获取特定实体（表、外部表、物化视图、函数或图）的详细架构。

kusto_graph_query 只读

使用快照或临时图执行图查询。

kusto_sample_entity 只读

从表、外部表、物化视图或函数中检索示例记录。

展开其余 31 个工具

kusto_ingest_inline_into_table 写入

将内联 CSV 数据摄取到指定表中。

kusto_get_shots 只读

使用本地 SLM 或 Azure OpenAI 嵌入查找语义相似的已保存 KQL 查询。

kusto_deeplink_from_query 只读

生成深链接 URL，用于在 Azure Data Explorer Web Explorer 或 Microsoft Fabric 查询工作台中打开 KQL 查询。

kusto_show_queryplan 只读

获取 KQL 查询的执行计划而不运行查询，返回计划统计信息、逻辑运算符树和执行提示。

kusto_diagnostics 只读

运行最佳努力的集群诊断命令套件，并返回统一摘要。

eventstream_list 只读

列出 Fabric 工作区中的所有 Eventstream。

eventstream_get 只读

获取特定 Eventstream 的详细信息。

eventstream_get_definition 只读

检索 Eventstream 的完整 JSON 定义。

eventstream_create 写入

创建新的 Eventstream，支持自定义配置。

eventstream_update 写入

修改现有 Eventstream 的设置和目标。

eventstream_delete 破坏性

删除 Eventstream 及其关联资源。

eventstream_start_definition 只读

开始 Eventstream 定义构建会话。

eventstream_get_current_definition 只读

获取当前正在构建的 Eventstream 定义。

eventstream_clear_definition 写入

清除当前构建的 Eventstream 定义。

eventstream_add_sample_data_source 写入

向 Eventstream 定义添加示例数据源。

eventstream_add_custom_endpoint_source 写入

向 Eventstream 定义添加自定义端点源。

eventstream_add_derived_stream 写入

向 Eventstream 定义添加派生流。

eventstream_add_eventhouse_destination 写入

向 Eventstream 定义添加 Eventhouse 目标。

eventstream_add_custom_endpoint_destination 写入

向 Eventstream 定义添加自定义端点目标。

eventstream_validate_definition 只读

验证 Eventstream 定义。

eventstream_create_from_definition 写入

从定义创建 Eventstream。

eventstream_list_available_components 只读

列出可用于 Eventstream 的组件。

activator_list_artifacts 只读

列出 Fabric 工作区中的所有 Activator 工件。

activator_create_trigger 写入

创建新的 Activator 触发器，支持 KQL 源监视和电子邮件/Teams 警报。

map_list 只读

列出 Fabric 工作区中的所有 Map 项。

map_get 只读

获取特定 Map 项的详细信息。

map_get_definition 只读

检索 Map 项的完整 JSON 定义。

map_create 写入

根据提供的配置创建新的 Map 项。

map_update_definition 写入

替换现有 Map 项的完整 JSON 定义。

map_update 写入

部分更新现有 Map 项的属性。

map_delete 破坏性

删除 Map 项及其关联配置。

使用场景

使用自然语言查询 Eventhouse 并分析趋势。

管理 Eventstreams，列出、创建、更新或删除实时数据流。

创建 Activator 触发器，在异常或条件满足时通过电子邮件或 Teams 接收警报。

从 JSON 配置创建和管理地图项，可视化地理空间数据。

支持客户端

VS Code

GitHub Copilot

依据项目文档列出，未经本站实测。

详细介绍

Fabric RTI MCP 服务器是 Microsoft Fabric Real-Time Intelligence (RTI) 的全面 Model Context Protocol (MCP) 服务器实现。它使 AI 代理能够通过 MCP 接口与 Fabric RTI 服务交互，支持对 Eventhouse 和 Azure Data Explorer 进行 KQL 查询、管理 Eventstreams、创建 Activator 触发器以及可视化和操作 Map 项。该服务器支持自然语言到 KQL 转换、安全认证（通过 Azure Identity）和实时数据访问。目前处于公共预览阶段。