AI导哈

销售仪表板扩展

Qanat Goose MCP扩展是一个基于代理的Goose MCP-UI扩展，集成了Square MCP服务器，通过语音和手势代理为卖家提供交互式仪表板。

  • by professordnyc
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 professordnyc/qanat-goose-mcp

使用说明

坎纳特鹅MCP扩展

🔄 您在寻找独立原型吗？看 卡纳特.

Qanat Goose MCP扩展是一个基于代理的Goose MCP-UI扩展，它封装了Square MCP服务器，将沙盒目录/订单与语音和手势代理集成在一个交互式卖家仪表板上。

🏗️ 建筑

Qanat作为自定义MCP-UI扩展与Goose Desktop集成：

Goose Desktop (MCP-UI surface)
    ↓
Qanat MCP-UI Extension ← Voice/Gesture Agents  
    ↓
Square MCP Server
    ↓  
Square API

🚀 快速开始

  1. 设置环境

    # Copy environment template
cp env.example .env

# Edit .env with your API keys
# SQUARE_API_KEY=your_key_here
# ELEVENLABS_API_KEY=your_key_here

  2. 再进行

    pip install -r requirements.txt

  3. 运行MCP服务器

    npm run dev
# or
python -m backend.mcp_servers.qanat_server

  4. 连接到Goose桌面

    • 在Goose设置中将Qanat添加为MCP-UI扩展
    • 服务器将在本地主机3001上运行

🔄 运行两个Qanat演示

Qanat有两个版本： Qanat（基线原型）

  • 使用Web Speech API和种子演示数据的独立仪表板。
  • 完全在浏览器中运行，当Square无法访问时，使用回退API。
  • 要运行：
  • 克隆坎儿井仓库。
  • 安装依赖项（npm Install）。
  • 启动后端模拟服务器（npm run-dev）。
  • 启动前端（cd前端和npm run-dev）。
  • 访问http://localhost:5173在Chrome浏览器中，允许麦克风访问。 Qanat Goose MCP扩展（高级）
  • Goose MCP‑UI扩展包装方形MCP服务器。
  • 将Square沙盒目录/订单与语音和手势代理集成。
  • 要运行：
  • 克隆坎儿井鹅mcp仓库。
  • 复制env.template→ .env并添加您的Square沙盒OAuth凭据。
  • 启动MCP服务器（npm run-dev或python-m backend.MCP_servers.qanat_server）。
  • 在Goose Desktop中，将Qanat添加为具有端点的MCP‑UI扩展http://localhost:3001.
  • 通过语音、手势或UI按钮进行交互。

📁 项目结构

qanat_v2/
├── backend/                    # Core backend services
│   ├── agents/                # Goose subagents (voice, gesture)
│   ├── services/              # Square API integration
│   └── mcp_servers/           # MCP protocol servers
├── config/                    # Configuration files
│   ├── extensions/            # Extension configs (Square, voice, gesture)
│   └── environments/          # Environment loading utilities
├── docs/                      # Project documentation
│   ├── PROJECT_BOARD.md       # Development task breakdown
│   ├── PLAN.md               # MVP development plan  
│   └── Qanat_Architecture_Overview.md
├── requirements.txt           # Python dependencies
├── package.json              # Project metadata & scripts
└── env.example               # Environment template

🎯 MVP功能

  • 目录仪表板：查看和管理Square目录项
  • 订单仪表板：监控最近的订单和状态更新
  • 语音控制：通过ElevenLabs执行“刷新目录”命令
  • 手势控制：通过MediaPipe用拇指向上手势切换项目状态
  • 交互式用户界面：Goose Desktop中的可点击表格和操作按钮

🛠️ 发展

看 文档/项目_BOARD.md 详细的开发任务和时间表。

关键组件

  • MCP-UI服务器: backend/mcp_servers/qanat_server.py
  • 广场一体化: backend/services/
  • 语音代理：使用ElevenLabs进行语音转文本
  • 手势代理：使用MediaPipe进行手势识别

配置文件

  • config/extensions/square_mcp.json -Square API集成配置
  • config/extensions/qanat_mcp_ui.json -UI组件定义
  • config/extensions/elevenlabs_voice.json -语音命令映射
  • config/extensions/mediapipe_gesture.json -手势识别设置

🔧 脚本

npm run dev          # Start development server
npm run start        # Start production server  
npm run test         # Run tests
npm run setup        # Install dependencies
npm run config       # Validate configuration

📋 环境变量

必需变量（从以下位置复制 env.example):

  • SQUARE_API_KEY -您的Square API密钥
  • SQUARE_ENVIRONMENT -沙盒/生产
  • ELEVENLABS_API_KEY -ElevenLabs API语音功能密钥
  • MEDIAPIPE_CONFIDENCE_THRESHOLD -手势检测灵敏度

🎮 用法

语音命令

  • “刷新目录”-重新加载目录项
  • “显示订单”-显示最近的订单
  • “帮助”-显示可用命令

手势控制

  • 👍 竖起大拇指 -切换项目活动/非活动状态
  • 👉 点 -选择表行
  • ✋ 张开手掌 -刷新当前视图
  • ✌️ 和平标志 -切换目录/订单视图

🧪 测试

# Run all tests
npm run test

# Test Square integration
python -m pytest tests/test_square_services.py

# Test voice commands  
python -m pytest tests/test_voice_agent.py

# Test gesture recognition
python -m pytest tests/test_gesture_agent.py

📝 许可证

MIT许可证-有关详细信息，请参阅许可证文件。

内置于❤️ 适用于使用Goose Desktop的方形卖家 ##鹅街区

联系

请点击此处或通过Discord联系我：@professordnyc

相关 MCP