使用说明
Microsoft Fabric MCP服务器-示例和测试
🔗 此存储库包含以下示例 Microsoft结构MCP服务器
真实世界的示例演示了如何使用Microsoft Fabric Model Context Protocol（MCP）服务器自动化Fabric操作，包括湖屋管理、笔记本电脑执行和数据填充工作流。
🚀 快速开始
1.先安装MCP服务器
⚠️ 重要：在使用这些示例之前，您需要安装主MCP服务器。
git clone https://github.com/santhoshravindran7/Fabric-Analytics-MCP.git
cd Fabric-Analytics-MCP
npm install && npm run build
2.设置您的配置
# Set your workspace ID (required)
export FABRIC_DEFAULT_WORKSPACE_ID="your-workspace-id-from-fabric-portal"
# Authenticate with Azure
az login
3.运行第一个示例
git clone https://github.com/your-username/Fabric-MCP-Testing.git
cd Fabric-MCP-Testing/examples/getting-started
node basic-demo.cjs
预期结果：✅ 使用62个可用的MCP工具验证连接
📁 存储库结构
🌟 示例（从这里开始）
| 目录 | 目的 | 关键文件 |
|---|---|---|
getting-started/ |
新用户介绍 | basic-demo.cjs -测试您的设置 |
data-population/ |
生产工作流程 | execute-notebook-livy-corrected.cjs -5K+记录 |
troubleshooting/ |
调试与调查 | test-capacity-issue.cjs -重现bug |
📚 文档
| 文件 | 描述 |
|---|---|
SETUP.md |
完整的设置说明 |
docs/DEMO_SUCCESS_SUMMARY.md |
详细的成功案例和工作流程 |
🗂️ 发展
| 目录 | 目的 |
|---|---|
notebooks/ |
用于测试的Jupyter笔记本 |
archive/ |
历史脚本和实验（仅限当地） |
🔧 这些示例的作用
基本操作
- ✅ MCP服务器连接：建立和测试连接
- ✅ 工作区访问：验证权限并列出项目
- ✅ 工具发现：查找所有62个可用的MCP功能
生产工作流程
- 🏭 数据总体：生成5000多条结构化记录
- 📊 湖屋创作：带桌子和数据的完整湖屋
- 📈 笔记本执行：自动Spark作业处理
- 🔍 会话管理：Livy API集成和监控
调试与故障排除
- 🐛 问题复制：已知问题的测试用例
- 🔍 调查脚本：深入了解MCP行为
- ⚠️ 错误处理：强大的错误捕获和报告
🛠️ 技术栈
- MCP服务器: 结构分析MCP
- 认证：Azure命令行界面(
az login) - 平台：Microsoft Fabric/Power BI高级版
- 应用程序编程接口：Microsoft Fabric REST API+Livy Spark API
- 语言：Node.js（CommonJS模块）
📊 实际结果
数据填充成功
📈 Results Summary:
├── 🏭 Lakehouse: Created with 3 tables
├── 📊 Records: 5,000+ structured entries
├── ⚡ Performance: Sub-minute execution
└── 🔄 Repeatability: 100% success rate
MCP集成
🔗 MCP Tools Available: 62 functions
├── 📁 Workspace Management: 5 tools
├── 🏠 Lakehouse Operations: 8 tools
├── 📔 Notebook Control: 12 tools
├── ⚡ Spark Job Management: 15 tools
└── 🔧 Utility Functions: 22 tools
🎯 用例
对于开发者
- 学习MCP集成：实际工作示例
- 测试您的设置：包括验证脚本
- 生产模式：久经考验的工作流程
数据工程师
- 自动化织物：Lakehouse创建和数据加载
- Spark工作流：笔记本执行和监控
- ETL管道：端到端数据处理示例
DevOps团队
- CI/CD集成：自动化结构部署
- 监控：错误处理和日志记录模式
- 故障排除：调试常见问题的脚本
🔗 相关项目
主要依赖关系
- 结构分析MCP -MCP服务器（必需）
- 模型上下文协议 -MCP规范
- Microsoft结构 -平台文档
已知问题和修复
🤝 贡献
- 测试场景 欢迎光临
examples/troubleshooting/ - 生产工作流程 需要在
examples/data-population/ - 文档改进 总是赞赏
- Bug复制 帮助主要项目
📄 许可证
MIT许可证-您可以在自己的项目中自由使用这些示例。
🆘 获取帮助
- 从开始:
examples/getting-started/basic-demo.cjs - 检查:
SETUP.md详细说明 - 使用调试：脚本在
examples/troubleshooting/ - 提出问题：大体上 结构分析MCP存储库
⭐ 标记此回购 如果这些示例帮助您开始使用Microsoft Fabric MCP自动化！
