HubSpot MCP Server

HubSpot MCP 服务器

概述

该项目实现了一个模型上下文协议 (MCP) 服务器，该服务器与 HubSpot CRM 集成，并新增了集中式共享空间功能。该服务器使 AI 模型能够通过标准化接口与 HubSpot 数据和操作进行交互，同时允许团队实时共享关键对话摘要。

有关模型上下文协议及其工作原理的更多信息，请参阅 Anthropic 的 MCP 文档。

成分

资源

没有资源得到落实。最终，系统是由工具驱动的。

示例提示

通过从 LinkedIn 个人资料网页复制来创建 HubSpot 联系人：

获取贵公司的最新活动：

共享空间示例：

会议结束后，AI 命令框会提示：“请问对话摘要是否应该存储在公司共享空间中？”（是/否）确认后，对话摘要将集中存储，公司所有授权经理都可以访问。

工具

该服务器提供了多种用于管理 HubSpot 对象的工具以及新的共享空间工具：

联系人管理工具

• hubspot_create_contact
  • 在 HubSpot 中创建新联系人（带有重复检查）。
  • 输入：
    • 名字（字符串）
    • 姓氏（字符串）
    • 电子邮件（字符串，可选）
    • 属性（字典，可选；例如，{“phone”：“123456789”，“company”：“HubSpot”}）

公司管理工具

• hubspot_create_company
  • 在 HubSpot 中创建一个新公司（并进行重复检查）。
  • 输入：
    • 名称（字符串）
    • 属性（字典，可选）
• hubspot_get_company_activity
  • 检索特定公司的活动历史记录。
  • 输入：
    • company_id（字符串）

参与工具

• hubspot_get_recent_engagements
  • 检索最近的参与活动。
  • 输入：
    • 天（整数，默认 7）
    • 限制（整数，默认 50）
• hubspot_get_recent_companies
  • 检索最近活跃的公司。
  • 输入：
    • 限制（整数，默认 10）
• hubspot_get_recent_contacts
  • 检索最近活动的联系人。
  • 输入：
    • 限制（整数，默认 10）

共享空间工具

• create_shared_summary
  • 在共享空间中创建新的对话摘要。
  • 输入：
    • user_id（字符串，用户的电子邮件/ID）
    • company_id（字符串）
    • 摘要（字符串）
• get_shared_summaries
  • 检索给定公司的所有对话摘要。
  • 输入：
    • 用户 ID（字符串）
    • company_id（字符串）

这些共享空间工具允许授权经理共享会议摘要，实现实时团队协作和集中访问关键见解。

设置

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 buryhuang/mcp-hubspot：

先决条件

您需要一个 HubSpot 访问令牌。您可以通过在您的 HubSpot 帐户中创建一个私有应用来获取该令牌（请参阅 HubSpot 私有应用指南）。请妥善保管您的令牌。

Docker 安装

**选项 1：**从 Docker Hub 拉取

**选项 2：**本地构建

运行容器：

或者将令牌作为参数传递：

跨平台发布

创建一个新的构建器实例：

构建并推动多个平台：

验证图像：

与 Claude Desktop 一起使用

通过 Smithery 安装

Docker 使用

或者使用命令行参数：

发展

设置开发环境：

共享空间整合

共享空间功能在一个单独的模块 (shared_space.py) 中实现。该模块：

• 加载动态用户角色（来自外部 JSON 文件或数据库）。
• 为对话摘要实现 CRUD 端点（create_summary、get_summaries、update_summary 和 delete_summary）。
• 触发实时通知占位符（您稍后可以将其与 SSE 或 WebSockets 集成）。

主 server.py 文件导入这些函数并将它们注册为新的 MCP 工具（create_shared_summary 和 get_shared_summaries）。

执照

该项目已获得 MIT 许可。

此更新的 README 现在反映了使用 HubSpot MCP 集成的附加共享空间功能，并解释了系统的结构和使用方式。