Hubspot Mcp Server

HubSpot MCP 服务

用于将 HubSpot 与 MCP 客户端（例如 Claude Desktop）集成的 MCP（Model Context Protocol）服务。通过对话式工具访问 HubSpot 联系人、公司和交易。

🛠️ 可用工具

该服务提供 18 个工具，实现全面的 HubSpot 集成：

类别	工具	描述
📋 实体列表	list_hubspot_contacts list_hubspot_companies list_hubspot_deals list_hubspot_engagements	列出并浏览 HubSpot 实体，支持分页
🔧 属性	get_hubspot_contact_properties get_hubspot_company_properties get_hubspot_deal_properties	获取每种实体类型的字段属性和架构
🔍 搜索与筛选	search_hubspot_contacts search_hubspot_companies search_hubspot_deals	使用筛选条件对每种实体类型进行高级搜索
💼 交易管理	get_deal_by_name create_deal update_deal	完整的交易生命周期管理
🤖 AI 驱动的搜索	semantic_search_hubspot manage_hubspot_embeddings browse_hubspot_indexed_data	使用 FAISS 向量数据库进行自然语言语义搜索
⚡ 缓存与性能	load_hubspot_entities_to_cache manage_hubspot_cache	批量加载、缓存和性能优化

工具的完整文档请参见：工具文档

---

⚡ 使用示例

完成安装和配置后（请遵循完整的安装指南），使用 MCP 客户端输入自然语言短语：

🗣️ 自然语言查询

• “列出我的 HubSpot 联系人”
• “查找科技行业的公司”
• “显示当前交易”
• “为 Project X 创建新交易”
• “搜索名为‘Project X’的交易”
• “有哪些联系人属性可用？”

🤖 AI 驱动的语义搜索

• “查找软件工程师” → 匹配“Developer”“Programmer”“Software Architect”
• “搜索企业客户” → 无需精确关键词即可找到大型公司
• “巴黎的科技公司” → 根据上下文搜索地点和行业

不同用法的完整文档请参见：使用示例

---

📚 文档目录

🚀 入门

章节	描述
客户端集成	MCP 客户端集成完整指南
Claude Desktop 集成	Claude Desktop 的 stdio 和 SSE 模式完整指南

🔧 其他功能

章节	描述
语义搜索	AI 驱动的语义搜索功能及用法
缓存系统	共享 TTL 缓存的工作原理及管理方法
SSE 端点	用于健康监控和数据管理的 REST API 端点

🛠️ 开发与测试

部分	描述
开发者指南	测试、质量保证和开发工作流
MCP Inspector	使用 MCP Inspector 进行可视化调试和测试
故障排除	常见问题及解决方案
集成测试	全面的测试流程
本地安装（stdio）	在本地安装和运行
远程部署（SSE）	部署到 Kubernetes 以供生产环境使用
环境设置	高级环境配置

📋 质量保证：Pre-commit 钩子会在每次提交时自动执行代码格式化、文档 lint 检查和失效链接检查。使用 just install-dev 安装。

---

🤝 参与贡献

查看贡献指南，了解：

• 开发标准
• 工具创建流程
• 代码和测试约定
• Git 工作流和语义化版本控制

---

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。