MCP Agenticai

🤖 MCP代理AI：高级商业智能演示

](https://asimrout-eng.github.io/mcp-agenticai/)   

两个前沿演示展示 AI 代理 利用Firebolt闪电般快速的分析平台进行商业智能分析。

🎯 两次突破性的人工智能演示

1. 🧠 自然语言到SQL

通过与Claude AI的集成，将业务问题转化为优化的SQL查询。

• 真正的Firebolt连接 通过MCP协议
• 亚秒级查询执行 具有性能跟踪功能
• 自动可视化 与Plotly集成
• 可编辑SQL 带有语法高亮显示

2. 🤖 代理AI商业智能 ⭐ *精选*

用于复杂业务分析的多步自主AI推理。

• 🧩 多步骤规划 -观看AI分解复杂问题
• 👀 推理透明度 -侧边栏中的实时计划跟踪
• 🎯 问题改编 -针对不同查询的不同分析
• 💡 战略洞察力 -带有信心评分的商业推荐
• 🎮 交互式执行 -逐步或自动分析

✨ 主要特点

🚀 先进的人工智能能力

• 克劳德3.5十四行诗 智能查询生成的集成
• 自主推理 假设形成和检验
• 业务背景理解 战略建议
• 多步骤分析工作流程 按问题类型改编

⚡ 企业级绩效

• 真正的Firebolt集成 通过模型上下文协议（MCP）
• 亚秒级分析 柱状数据仓库
• 动态模式发现 具有自动工作台检测功能
• 性能监控 具有执行时间跟踪功能

🎨 现代用户体验

• 漂亮的Streamlit界面 响应式设计
• 交互式可视化 具有自动图表生成功能
• 实时更新 具有规划跟踪可见性
• 专业用户界面 适合客户演示

🚀 快速开始

选项1：尝试现场演示（推荐）

访问 **** 用于：

• ✅ 完整文档 和设置指南
• ✅ 交互式示例 和用例
• ✅ 无需安装 -只是探索！

选项2：本地运行

# 1. Clone repository
git clone https://github.com/asimrout-eng/mcp-agenticai.git
cd mcp-agenticai

# 2. Install dependencies  
pip install -r requirements.txt

# 3A. Run Natural Language to SQL Demo
./run.sh your_anthropic_api_key
# Access: http://localhost:8504

# 3B. Run Agentic AI Demo (Featured)
./run_agentic_demo.sh your_anthropic_api_key
# Access: http://localhost:8505

🔐 安全：API键作为参数提供，从不存储在文件中。

📁 项目结构

mcp-agenticai/
├── 🤖 Agentic AI Demo
│   ├── agentic_ai_demo.py           # Multi-step AI reasoning interface
│   ├── agentic_nl2sql.py            # Enhanced NL2SQL for agent workflows
│   └── run_agentic_demo.sh          # Launch agentic AI demo
│
├── 🧠 Natural Language to SQL
│   ├── app.py                       # NL2SQL Streamlit application
│   ├── nl2sql_claude.py             # Claude API integration
│   └── run.sh                       # Launch NL2SQL demo
│
├── 🔌 Database Integration
│   ├── test_mcp_real.py             # MCP server communication
│   └── requirements.txt             # Python dependencies
│
├── 🌐 GitHub Pages Site
│   └── docs/                        # Professional demo website
│       ├── index.html               # Landing page
│       ├── demos/nl2sql.html        # NL2SQL documentation  
│       └── demos/agentic-ai.html    # Agentic AI guide
│
└── 📚 Documentation
    ├── README.md                    # This file
    ├── AGENTIC_AI_DEMO_README.md    # Detailed agentic AI guide
    └── GITHUB_PAGES_SETUP.md       # Deployment instructions

🤖 是什么让这个“代理”

🧩 多步推理

与简单的NL2SQL不同，代理AI 自主故障 复杂的商业问题：

• 发现 → 分析 → 假设 → 验证 → 推荐
• 每一步都建立在之前的发现之上
• 根据问题类型调整分析方法

👀 透明决策

实时观察AI代理的思维过程：

• 计划跟踪侧栏 显示逐步推理
• 信心评分 对于每个分析步骤
• 洞察力积累 随着调查的进展

🎯 商业智能焦点

超越数据查询，提供战略价值：

• 收入优化 策略
• 市场拓展 建议
• 玩家留存率 改进计划
• 性能基准测试 具有可操作的见解

🔧 配置

环境变量（可选）

您可以通过环境变量预先配置凭据，也可以直接在UI中输入凭据。 复制 env_example.txt 到 .env 并更新您的凭据：

# Firebolt MCP Server Credentials
FIREBOLT_MCP_ACCOUNT=your_account
FIREBOLT_MCP_DATABASE=your_database  
FIREBOLT_MCP_ENGINE=your_engine
FIREBOLT_MCP_CLIENT_ID=your_service_account_id
FIREBOLT_MCP_CLIENT_SECRET=your_service_account_secret

# Claude API (NOT STORED - API key passed via command line only)
# ANTHROPIC_API_KEY=provided_at_runtime_via_command_line

🎯 运作原理

1. 连接：在UI中输入您的Firebolt凭据（或通过环境变量进行配置）
2. 发现：应用程序会自动发现所有表、列、DDL和主索引
3. 问：用自然语言键入您的问题
4. 转换：Claude AI将您的问题转换为优化的Firebolt SQL
5. 编辑：如果需要，请查看并修改生成的SQL
6. 执行：在实时Firebolt数据库上运行查询
7. 分析：查看执行时间和自动生成的可视化结果

💡 演示场景

🧠 自然语言到SQL示例

-- "Show me revenue by country for premium players"
SELECT country, SUM(amount_usd) as revenue 
FROM players p JOIN transactions t ON p.player_id = t.player_id 
WHERE p.is_premium = true GROUP BY country ORDER BY revenue DESC;

🤖 代理人工智能商业问题

提出复杂、多方面的问题，并观察AI代理通过这些问题进行推理：

收入情报： *“是什么推动了我们的游戏收入，我们应该担心吗？”* → 代理人制定6步风险评估分析计划

玩家分析：\ *“玩家参与度如何与长期价值相关？”* → Agent通过统计验证执行相关性分析

市场战略： *“我们应该优先考虑哪些地理市场进行扩张？”*\ → 代理商通过投资回报率预测评估机会

🎯 用例

面向销售和营销团队

• 客户演示：专业AI展示
• 区域分析：地理性能见解
• 活动优化：投资回报率和转化率分析

产品和工程团队

• 功能分析：用户参与度分析
• 性能监控：系统优化见解
• 技术展示：先进的人工智能能力

对于行政领导

• 战略规划：市场扩张战略
• 投资决策：投资回报率和增长预测
• 竞品分析：性能基准测试

🏗️ 建筑

graph TB
    A[Complex Business Question] --> B[Agentic AI Planner]
    B --> C[Multi-Step Analysis Plan]
    C --> D[Step Execution Engine]
    D --> E[Claude 3.5 Sonnet]
    E --> F[MCP Protocol] 
    F --> G[Firebolt Database]
    G --> H[Business Intelligence]
    H --> I[Strategic Recommendations]
    
    J[Planning Trace] --> K[Real-time UI Updates]
    D --> J

🔧 技术栈

🛠️ 发展

核心文件

• app.py -主Streamlit UI和用户交互
• nl2sql_claude.py -Claude AI集成与快速工程
• test_mcp_real.py -MCP服务器通信和查询执行

📈 性能和优势

⚡ 技术性能

• 亚秒级查询 关于Firebolt的柱状发动机
• 实时分析 实时更新规划跟踪
• 可扩展架构 已准备好进行企业部署
• 专业用户界面 适合客户演示

💼 商业价值

• 更快的洞察力 具有自然语言界面
• 战略建议 从代理人工智能推理
• 改进决策 具有透明的人工智能流程
• 提高生产率 通过自动化商业智能

🤝 贡献与社区

该项目展示 智能人工智能的实际应用 对于商业智能：

• 🐛 问题: 报告错误或请求功能
• 💡 想法：分享改进建议
• ⭐ 星如果你觉得这个有用，就给它一颗星！
• 🔄 分叉：创建自己的版本或回馈

📞 资源与支持

• 🌐 现场演示:
• 📚 Firebolt文档: https://docs.firebolt.io/
• 🤖 克劳德·艾: https://www.anthropic.com/claude
• 🔗 MCP协议: 模型上下文协议

📄 许可证

______________________________________________________________________

🌟 星迹

如果这个项目为您的商业智能需求展示了有价值的人工智能应用程序，请考虑在存储库中担任主角！

______________________________________________________________________

🤖 内置于❤️ 展示代理人工智能在商业智能中的未来