Housecall Pro MCP服务器
Housecall Pro现场服务管理平台的完整模型上下文协议(MCP)服务器。采用全面的工具、React应用程序和全面的API集成,符合GHL质量标准。
特性
- 109 MCP工具 跨越17个领域
- 15个React应用程序 用于可视化管理
- API全面覆盖 具有承载令牌身份验证、分页、错误处理和速率限制
- TypeScript 严格的类型检查
- 深色主题UI 适用于所有React应用程序
安装
npm install
npm run build配置
设置以下环境变量:
export HOUSECALL_PRO_API_KEY="your_api_key_here"可选:
export HOUSECALL_PRO_BASE_URL="https://api.housecallpro.com" # Default用法
作为MCP服务器(stdio)
npx housecall-pro-mcpClaude桌面中的配置
增添 claude_desktop_config.json:
{
"mcpServers": {
"housecall-pro": {
"command": "npx",
"args": ["-y", "@mcpengine/housecall-pro"],
"env": {
"HOUSECALL_PRO_API_KEY": "your_api_key_here"
}
}
}
}可用工具(109)
工作(12工具)
list_jobs-列出带有筛选器的作业get_job-获取作业详细信息create_job-创建新作业update_job-更新作业complete_job-标记作业完成cancel_job-取消作业list_job_line_items-列出作业行项目add_job_line_item-将行项目添加到作业中schedule_job-安排作业reschedule_job-重新安排作业assign_employee-为员工分配工作get_dispatch_board-查看调度板
客户(6工具)
list_customers-列出所有客户get_customer-获取客户详细信息create_customer-创建新客户update_customer-更新客户delete_customer-删除客户search_customers-搜索客户
估算(6种工具)
list_estimates-列出估计数get_estimate-获取估算详细信息create_estimate-创建新估算send_estimate-向客户发送估价approve_estimate-标记估算已批准convert_estimate_to_job-转换为作业
发票(6个工具)
list_invoices-列出发票get_invoice-获取发票详细信息create_invoice-创建新发票send_invoice-向客户发送发票mark_invoice_paid-将发票标记为已付款list_invoice_payments-列出发票付款
付款(8种工具)
list_payments-列出所有付款get_payment-获取付款详细信息create_payment-记录新付款refund_payment-处理退款void_payment-取消付款process_card_payment-处理卡支付list_payment_methods-列出已保存的付款方式delete_payment_method-删除付款方式
员工(6个工具)
list_employees-列出所有员工get_employee-获取员工详细信息create_employee-创建新员工update_employee-更新员工get_employee_schedule-获取员工日程表get_employee_performance-获取性能指标
日程安排(7个工具)
get_schedule-获取日期范围的日程表check_availability-检查员工可用性find_available_slots-查找可用的时间段create_time_off-创建休息时间块delete_time_off-删除休息时间块list_recurring_schedules-列出重复时间表create_recurring_schedule-创建定期计划
调度(3个工具)
get_dispatch_board-获取调度板视图assign_employee-为员工分配工作get_employee_availability-检查可用性
标签(5工具)
list_tags-列出所有标签create_tag-创建新标签delete_tag-删除标签add_tag_to_job-标记作业add_tag_to_customer-标记客户
通知(2个工具)
list_notifications-列出通知send_notification-发送短信/电子邮件通知
评论(3工具)
list_reviews-列出客户评论get_review-获取评论详细信息request_review-请求客户审核
报告(3个工具)
get_revenue_report-收入分析get_job_completion_report-作业完成指标get_employee_performance_report-员工绩效
价格手册(8个工具)
list_pricebook_items-列出目录项get_pricebook_item-获取商品详细信息create_pricebook_item-创建新项目update_pricebook_item-更新项目delete_pricebook_item-删除项目list_pricebook_categories-列出类别create_pricebook_category-创建类别bulk_update_prices-批量价格更新
线索(6个工具)
list_leads-列出所有潜在客户get_lead-获取潜在客户详细信息create_lead-创建新线索update_lead-更新潜在客户convert_lead_to_customer-转换为客户delete_lead-删除潜在客户
Webhooks(7个工具)
list_webhooks-列出webhook订阅get_webhook-获取webhook详细信息create_webhook-创建webhook订阅update_webhook-更新webhookdelete_webhook-删除webhooktest_webhook-发送测试事件list_webhook_deliveries-列出交付尝试
时间追踪(8个工具)
list_time_entries-列出时间条目get_time_entry-获取参赛详情clock_in-员工打卡clock_out-打卡员工create_manual_time_entry-手动输入update_time_entry-更新条目delete_time_entry-删除条目get_employee_hours-获取总小时数
设置(8个工具)
get_company_info-获取公司信息update_company_info-更新公司信息get_business_hours-获取营业时间update_business_hours-更新营业时间get_notification_settings-获取通知设置update_notification_settings-更新通知get_tax_settings-获取税务设置update_tax_settings-更新税务设置
React应用程序(15)
所有应用程序都具有深色主题、响应式设计和MCP API集成功能。
- 招聘板 -具有状态过滤的所有作业的网格视图
- 作业详细信息 -带有行项目和时间线的详细作业视图
- 客户列表 -可搜索的客户目录
- 客户详细信息 -包含工作历史的客户资料
- 日程日历 -可视化调度界面
- 估算生成器 -创建和管理估算
- 发票仪表板 -发票跟踪和管理
- 员工经理 -团队成员管理
- 查看仪表板 -客户评价分析
- 付款跟踪器 -付款和收入跟踪
- 价目表 -服务目录管理
- 调度映射 -地理调度视图
- 通知中心 -通知管理
- 报告仪表板 -分析和见解
- 设置面板 -系统配置
构建React应用程序
每个应用程序都可以使用Vite独立构建:
cd src/ui/react-app/src/apps/job-board
npm install
npm run devAPI客户端
这 HousecallProClient 类提供:
- 承载令牌身份验证 -安全的API密钥身份验证
- 自动分页 -处理多页响应
- 错误处理 -全面的错误类型
- 速率限制 -内置重试逻辑
- 类型安全 -完整的TypeScript类型
发展
# Install dependencies
npm install
# Build server
npm run build
# Watch mode
npm run dev
# Type check
npx tsc --noEmit
# Clean build
npm run clean && npm run build建筑
src/
├── clients/
│ └── housecall-pro.ts # API client with all endpoints
├── tools/
│ ├── jobs-tools.ts # Job management tools
│ ├── customers-tools.ts # Customer management tools
│ ├── estimates-tools.ts # Estimate tools
│ ├── invoices-tools.ts # Invoice tools
│ ├── payments-tools.ts # Payment processing tools
│ ├── employees-tools.ts # Employee management tools
│ ├── scheduling-tools.ts # Scheduling tools
│ ├── dispatch-tools.ts # Dispatch tools
│ ├── tags-tools.ts # Tag management tools
│ ├── notifications-tools.ts # Notification tools
│ ├── reviews-tools.ts # Review tools
│ ├── reporting-tools.ts # Analytics tools
│ ├── pricebook-tools.ts # Price book tools
│ ├── leads-tools.ts # Lead management tools
│ ├── webhooks-tools.ts # Webhook management tools
│ ├── timetracking-tools.ts # Time tracking tools
│ ├── settings-tools.ts # Settings management tools
│ └── index.ts # Tool registry
├── types/
│ └── index.ts # TypeScript interfaces
├── ui/
│ └── react-app/
│ └── src/
│ └── apps/
│ ├── job-board/
│ ├── customer-list/
│ ├── invoice-dashboard/
│ ├── estimate-builder/
│ ├── schedule-calendar/
│ ├── employee-manager/
│ ├── payment-tracker/
│ ├── price-book/
│ ├── dispatch-map/
│ ├── review-dashboard/
│ ├── report-dashboard/
│ ├── settings-panel/
│ ├── notification-center/
│ ├── job-detail/
│ └── customer-detail/
├── server.ts # MCP server implementation
├── main.ts # Entry point (stdio)
└── index.ts # Main export许可证
麻省理工学院
支持
有关问题或疑问,请访问:https://github.com/mcpengine/housecall-pro
