🏠 Housecall Pro MCP服务器
全面收集 模型上下文协议（MCP）服务器 用于Housecall Pro API，使Claude Desktop和其他具有MCP功能的LLM能够与Housecall专业现场服务管理系统无缝交互。每个服务器都专门用于特定的域，提供对客户、作业、日程安排、发票、材料等的模块化访问。
🚀 概述
该项目提供 20+专用MCP服务器 通过Claude Desktop或其他LLM公开完整的Housecall Pro API。无论您是管理客户、安排工作、处理发票还是跟踪材料，这些服务器都能为您提供强大的人工智能辅助访问您的现场服务操作。
🏗️ 建筑
每个Housecall Pro API域都有自己的专用MCP服务器，用于集中、高效的操作：
📋 核心业务运营
housecallpro_customers.py-客户和地址管理housecallpro_jobs.py-作业管理、调度和调度housecallpro_employees.py-员工管理和过滤housecallpro_appointments.py-预约安排和状态管理
💰 财务管理
housecallpro_invoices.py-发票管理和付款housecallpro_invoices_query.py-高级发票查询housecallpro_job_invoices.py-特定作业的发票操作housecallpro_estimates.py-估算创建和管理
📦 库存和材料
housecallpro_materials.py-材料管理和定价housecallpro_material_categories.py-物料类别组织housecallpro_price_forms.py-价格簿和表格管理
🎯 销售与营销
housecallpro_leads.py-潜在客户管理和转换housecallpro_lead_sources.py-线索来源跟踪housecallpro_tags.py-标签管理和组织
⚙️ 系统和配置
housecallpro_company.py-公司信息和设置housecallpro_job_types.py-作业类型配置housecallpro_schedule.py-进度管理housecallpro_events.py-活动和日历管理housecallpro_webhooks.py-Webhook配置和管理housecallpro_application.py-应用程序设置和首选项housecallpro.py-具有核心功能的统一服务器
🌟 主要特点
📋 客户管理(housecallpro_customers.py)
客户运营
- 获得客户 -使用高级筛选（搜索、日期范围、分页）列出客户
- 按ID获取客户 -检索详细的客户资料
- 创建客户 -添加具有完整信息的新客户
- 更新客户 -修改现有客户详细信息
地址管理
- 获取客户地址 -列出客户的所有地址
- 通过ID获取客户地址 -检索特定地址详细信息
- 创建客户地址 -为客户添加服务地点
👥 员工管理(housecallpro_employees.py)
员工运营
- 招聘员工 -按以下方式筛选员工：
- 活动状态、角色、标签 - 姓名、电子邮件、电话搜索 - 自定义分页和排序
- 按ID获取员工 -详细的员工资料，包括：
- 个人信息（联系方式、头像） - 雇佣信息（角色、雇佣日期、状态） - 权限和访问级别 - 标签和元数据
💼 作业管理(housecallpro_jobs.py)
核心作业操作
- 获取工作 -高级职位列表，带有以下过滤器：
- 状态（已计划、正在进行、已完成、已取消） - 客户、员工、日期范围 - 职位编号、描述、地址搜索 - 工作状态、业务部门、标签
- 按ID获取作业 -完整的作业详细信息，包括行项目、日程安排、附件
- 创造就业 -通过客户分配、日程安排和派遣，全面创造就业机会
作业调度和调度
- 更新作业计划 -修改时间和约会
- 删除作业计划 -删除已安排的约会
- 将工作分派给员工 -指派技术人员和工作人员
行项目管理
- 获取/添加/更新/删除作业行项目 -完成行项目操作
- 批量更新行项目 -高效的批量更新
- 获取/更新工作输入材料 -物料使用跟踪
工作文件
- 添加工作附件 -上传文件、照片、文档
- 添加/删除作业注释 -内部沟通和跟踪
- 创建工作链接 -外部资源管理
- 添加/删除作业标签 -组织和分类
📅 预约管理(housecallpro_appointments.py)
核心任命操作
- 获取预约 -按客户、员工、状态、日期筛选的列表
- 通过ID获取预约 -详细预约信息
- 创建/更新/删除约会 -完整的预约生命周期管理
日程安排和管理
- 重新安排预约 -使用客户通知移动约会
- 获取预约可用性 -查找可用的日程安排时间
- 发送预约提醒 -客户通信自动化
状态管理
- 标记预约已到达/开始/完成 -实时状态跟踪
- 标记预约未显示 -处理客户缺席
💰 发票管理(housecallpro_invoices.py)
发票操作
- 获取发票 -按状态、客户、日期、付款状态进行高级筛选
- 按ID获取发票 -完整的发票详细信息，包括行项目和附件
- 创建发票 -根据具有自定义条款的作业生成发票
- 更新发票 -修改金额、到期日、条款、消息
付款和处理
- 发送发票 -使用自定义消息发送电子邮件/短信
- 标记发票已支付 -通过多种方式记录付款
- 无效发票 -取消发票并跟踪原因
- 获取发票付款 -付款历史和跟踪
行项目管理
- 添加/更新/删除发票行项目 -详细发票构成
- 获取发票附件 -支持文件
- 下载发票PDF -生成格式化发票
📦 材料管理(housecallpro_materials.py)
物料操作
- 获取材料 -按类别列出材料并进行筛选
- 获取材料类别 -分层类别浏览
- 按名称查找类别 -搜索类别结构
- 创建/更新/删除材料 -完整的材料生命周期
💡 估算管理(housecallpro_estimates.py)
估算运营
- 获取估算 -按状态、客户、员工、日期筛选
- 按ID获取估算 -完整的估算细节和选项
- 创建估算 -使用多个选项生成估计值
估算选项管理
- 创建估算选项附件/链接 -支持文件
- 更新估算选项时间表 -时间线管理
- 创建/删除估算选项注释 -内部跟踪
🎯 潜在客户管理(housecallpro_leads.py)
领导运营
- 获取潜在客户 -按来源、状态、员工、日期进行高级筛选
- 通过ID获取线索 -完整的潜在客户信息和历史记录
- 创建潜在客户 -用完整的细节捕捉新的潜在客户
- 更新销售线索 -修改潜在客户信息和状态
- 转换潜在客户 -将潜在客户转化为客户
领导沟通
- 添加潜在客户备注 -跟踪沟通和跟进
- 删除潜在客户备注 -清理潜在客户历史记录
🏷️ 组织和标记(housecallpro_tags.py)
标签管理
- 获取标签 -列出所有可用标签并进行筛选
- 按ID获取标签 -详细标签信息
- 创建标签 -添加新的组织标签
- 更新标签 -修改标记属性
- 删除标记 -删除未使用的标签
⚙️ 系统配置
公司管理(housecallpro_company.py)
- 获取公司信息 -业务详细信息和设置
工作类型(housecallpro_job_types.py)
- 获取工作类型 -列出可用的服务类型及其定价
进度管理(housecallpro_schedule.py)
- 获取日程表 -查看技术人员时间表和可用性
活动(housecallpro_events.py)
- 获取活动 -日历事件和日程安排冲突
网上挂钩（housecallpro_webhooks.py)
- 获取/创建/更新/删除Webhooks -实时集成管理
先决条件
- Python 3.8+
- 紫外线 包管理器
- Housecall Pro API密钥
- Claude桌面应用程序或其他MCP LLM客户端
安装说明
1.安装uv（如果尚未安装）
窗户：
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"macOS/Linux：
curl -LsSf https://astral.sh/uv/install.sh | sh2.克隆和设置项目
git clone https://github.com/BuildWithBeacon/housecallpro-mcp.git
cd HousecallPro-mcp
uv sync或者下载ZIP并解压缩到所选目录。
3.获取Housecall Pro API密钥
- 登录您的Housecall Pro帐户
- 前往应用商店>API密钥管理>生成
- 生成API密钥
- 复制您的API密钥（确保其安全！）
4.环境设置
将“.env.example.”更改为“.env” 填写API密钥，后面没有空格=
5.配置克劳德桌面
复制claude_desktop.json模板并粘贴到您的AI MCP服务器配置中。
更新路径 claude_desktop_config.json:
备注：API密钥将自动从您的 .env file-不需要将其包含在JSON配置中。重要：如果uv不在系统PATH中，请替换"uv"具有uv可执行文件的完整路径（例如。，"C:\\Users\\YourUsername\\.cargo\\bin\\uv.exe"在Windows上）。
窗户：
{
"mcpServers": {
"housecall-pro-customers": {
"command": "uv",
"args": [
"--directory",
"C:\\\\Users\\\\YourUsername\\\\path\\\\to\\\\HousecallPro-mcp",
"run",
"housecallpro_customers.py"
]
}
}
}等等。从提供的模板中添加所有服务器，并更改克隆位置的路径。
macOS/Linux：
{
"mcpServers": {
"housecall-pro-customers": {
"command": "uv",
"args": [
"--directory",
"/Users/yourusername/path/to/HousecallPro-mcp",
"run",
"housecallpro_customers.py"
]
}
}
}等等。从提供的模板中添加所有服务器，并更改克隆位置的路径。
6.重新启动克劳德桌面
配置后，重新启动Claude Desktop以加载新的MCP服务器。现在，您应该在搜索和工具选项卡中看到可用的MCP服务器。
📝 使用示例
配置后，您可以向Claude询问以下问题：
- “显示所有客户”
- 获取“name”的客户ID
- “创建一个名为John Doe的新客户”
- “列出客户12345的所有地址”
- “为客户12345添加新地址”
🛠️ 故障排除
常见问题：
- “找不到服务器”
- 检查路径是否正确 claude_desktop_config.json 是正确的 - 确保 uv 已安装且可访问 - 如果 uv 也找不到命令： - 添加 uv 到您的系统PATH，或 - 使用完整路径 uv 在配置中（例如。， C:\\Users\\YourUsername\\.cargo\\bin\\uv.exe 在Windows上）
- “身份验证失败”
- 在中验证您的API密钥 .env 文件 - 检查您的Housecall Pro API密钥是否具有必要的权限
- “权限被拒绝”
- 确保Python文件是可执行的 - 检查uv是否具有适当的权限
🤝 贡献
- 分叉存储库
- 创建要素分支
- 添加您的改进
- 提交拉取请求
📄 许可证
它不是，随心所欲地使用它