适合谁
- 使用 Microsoft Fabric RTI 并希望通过 AI 代理以自然语言交互查询数据的团队。
- 需要快速分析流式数据并自动生成 KQL 查询的数据工程师。
- 希望自动化实时数据监控和警报（如 Activator 触发器和事件流管理）的开发人员。
- 需要可视化地理空间数据并与地图项交互的分析师。
F
65FMRS · C
该服务器是微软官方维护的 MCP 服务器，用于将 AI 代理连接到 Fabric RTI，提供广泛的工具集，包括 KQL 查询、事件流管理和地图操作。它提供了自然语言界面，并获得了良好的文档支持。但是，它处于预览阶段，并需要仔细的权限管理以安全使用。
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）和实时数据访问。目前处于公共预览阶段。
工具能力
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
从表、外部表、物化视图或函数中检索示例记录。
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 项及其关联配置。
安装接入
通过 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 并选择包。
claude_desktop_config.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"
}
}
}
}
选型与风险
不适合谁
- 需要生产级、已验证的 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）需要额外配置（如嵌入端点和表）。
常见排障
- 检查身份验证：确保已通过 Azure CLI、Visual Studio、Azure PowerShell 或浏览器登录，并具有访问权限。
- 检查环境变量：验证 KUSTO_SERVICE_URI 和 KUSTO_SERVICE_DEFAULT_DB 是否正确设置。
- 检查权限：为用户分配所需的 Fabric RBAC 角色，以执行查询、创建或删除操作。
- 检查网络：确保客户端可以访问 Fabric 和 Azure Data Explorer 端点。
- 对于远程部署，验证 HTTP 模式的配置（如 FABRIC_RTI_HTTP_PORT）和身份验证令牌。
使用场景
使用自然语言查询 Eventhouse 并分析趋势。
管理 Eventstreams，列出、创建、更新或删除实时数据流。
创建 Activator 触发器，在异常或条件满足时通过电子邮件或 Teams 接收警报。
从 JSON 配置创建和管理地图项，可视化地理空间数据。
支持客户端
VS Code完整支持
GitHub Copilot完整支持