坎纳特鹅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🚀 快速开始
- 设置环境
# 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- 再进行
pip install -r requirements.txt- 运行MCP服务器
npm run dev
# or
python -m backend.mcp_servers.qanat_server- 连接到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