HubSpot MCP 服务器

概述

这是一个模型上下文协议 (MCP) 服务器实现，提供与 HubSpot CRM 的集成。此服务器通过标准化接口使 AI 模型能够与 HubSpot 数据和操作进行交互。

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

组件

资源

没有实现资源。最终，工具是我们所需要的全部。

示例提示

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

  根据以下信息创建 HubSpot 联系人和公司：
  
  John Doe
  Tech Corp 公司的软件工程师
  旧金山湾区 • 500+ 个联系人
  
  工作经历
  Tech Corp
  软件工程师
  2020 年 1 月 - 至今 · 4 年
  加利福尼亚州旧金山
  
  前雇主公司
  高级开发人员
  2018 - 2020 · 2 年
  
  教育背景
  加利福尼亚大学伯克利分校
  计算机科学学士
  2014 - 2018
  

• 获取您公司的最新活动：

  我的销售管道最近发生了什么？
  

工具

该服务器提供了几个用于管理 HubSpot 对象的工具：

联系人管理工具

• hubspot_create_contact
  • 在 HubSpot 中创建新联系人（在创建前检查重复项）
  • 输入参数：
    • firstname (字符串): 联系人的名字
    • lastname (字符串): 联系人的姓氏
    • email (字符串, 可选): 联系人的电子邮件地址
    • properties (字典, 可选): 额外的联系人属性
      • 示例: {"phone": "123456789", "company": "HubSpot"}
  • 行为：
    • 检查是否存在具有相同名字和姓氏的现有联系人
    • 如果在属性中提供了 company，还会检查与同一公司的匹配项
    • 如果找到匹配项，则返回现有联系人的详细信息
    • 仅在未找到匹配项时创建新联系人

公司管理工具

• hubspot_create_company

  • 在 HubSpot 中创建新公司（在创建前检查是否存在重复）
  • 输入：
    • name (字符串): 公司名称
    • properties (字典, 可选): 额外的公司属性
      • 示例: {"domain": "example.com", "industry": "Technology"}
  • 行为：
    • 检查是否存在同名的公司
    • 如果找到匹配项，则返回现有公司的详细信息
    • 仅当未找到匹配项时才创建新公司

• hubspot_get_company_activity

  • 获取特定公司的活动历史记录
  • 输入：
    • company_id (字符串): HubSpot 公司 ID
  • 返回: 活动对象数组

Engagement 工具

• hubspot_get_recent_engagements

  • 获取所有联系人和公司的最近互动活动
  • 输入：
    • days (整数, 可选): 回溯的天数 (默认: 7)
    • limit (整数, 可选): 要返回的最大互动数量 (默认: 50)
  • 返回: 带有完整元数据的互动对象数组

• hubspot_get_recent_companies

  • 从 HubSpot 获取最近活跃的公司
  • 输入：
    • limit (整数, 可选): 要返回的最大公司数量 (默认: 10)
  • 返回: 带有完整元数据的公司对象数组

• hubspot_get_recent_contacts

  • 从 HubSpot 获取最近活跃的联系人
  • 输入：
    • limit (整数, 可选): 要返回的最大联系人数量 (默认: 10)
  • 返回: 带有完整元数据的联系人对象数组

设置

通过 Smithery 安装

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

npx -y @smithery/cli install buryhuang/mcp-hubspot --client claude

前提条件

您需要一个 HubSpot 访问令牌。可以通过以下步骤获取：

1. 在您的 HubSpot 账户中创建一个私有应用：
   请参考 HubSpot 私有应用指南
   • 进入您的 HubSpot 账户设置
   • 导航到集成 > 私有应用
   • 点击“创建私有应用”
   • 填写基本信息：
     • 为应用命名
     • 添加描述
     • 上传标志 (可选)
   • 定义所需的作用域：
     • tickets
     • crm.objects.contacts.write
     • crm.objects.contacts.sensitive.read
     • crm.objects.companies.sensitive.read
     • sales-email-read
     • crm.objects.deals.sensitive.read
     • crm.objects.companies.write
     • crm.objects.companies.read
     • crm.objects.deals.read
     • crm.objects.deals.write
     • crm.objects.contacts.read
   • 审核并创建应用
   • 复制生成的访问令牌

注意：请确保您的访问令牌安全，不要将其提交到版本控制系统。

Docker 安装

您可以选择从本地构建镜像或从 Docker Hub 拉取镜像。该镜像是为 Linux 平台构建的。

支持的平台

• Linux/amd64
• Linux/arm64
• Linux/arm/v7

选项 1: 从 Docker Hub 拉取

docker pull buryhuang/mcp-hubspot:latest

选项 2: 本地构建

docker build -t mcp-hubspot .

运行容器：

docker run \
  -e HUBSPOT_ACCESS_TOKEN=your_access_token_here \
  buryhuang/mcp-hubspot:latest

你可以直接将访问令牌作为命令行参数传递：

docker run \
  buryhuang/mcp-hubspot:latest \
  --access-token your_access_token_here

跨平台发布

要为多个平台发布 Docker 镜像，可以使用 docker buildx 命令。请按照以下步骤操作：

1. 创建一个新的构建器实例（如果你还没有的话）：

   docker buildx create --use
   

2. 为多个平台构建并推送镜像：

   docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t buryhuang/mcp-hubspot:latest --push .
   

3. 验证镜像是否可用于指定的平台：

   docker buildx imagetools inspect buryhuang/mcp-hubspot:latest
   

与 Claude Desktop 一起使用

通过 Smithery 安装

要通过 Smithery 自动安装 mcp-hubspot 到 Claude Desktop：

npx -y @smithery/cli@latest install mcp-hubspot --client claude

Docker 使用

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HUBSPOT_ACCESS_TOKEN=your_access_token_here",
        "buryhuang/mcp-hubspot:latest"
      ]
    }
  }
}

你也可以使用命令行参数：

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "buryhuang/mcp-hubspot:latest",
        "--access-token",
        "your_access_token_here"
      ]
    }
  }
}

开发

要设置开发环境：

pip install -e .

许可证

本项目根据 MIT 许可证许可。