HubSpot MCP 服务器

概述

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

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

<a href="https://glama.ai/mcp/servers/vpoifk4jai"><img width="380" height="200" src="https://glama.ai/mcp/servers/vpoifk4jai/badge" alt="HubSpot Server MCP server" /></a>

组件

资源

未实现任何资源。归根结底，我们只需要工具。

示例提示

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

  从以下信息创建 HubSpot 联系人和公司：
  
  John Doe
  Tech Corp 的软件工程师
  旧金山湾区 • 500+ 连接
  
  经验
  Tech Corp
  软件工程师
  2020 年 1 月 - 至今 · 4 年
  加利福尼亚州旧金山
  
  Previous Company Inc.
  高级开发人员
  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
  • 返回：活动对象数组

互动工具

• hubspot_get_recent_engagements

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

• hubspot_get_recent_companies

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

• hubspot_get_recent_contacts

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

设置

通过 Smithery 安装

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

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 为 Claude Desktop 自动安装 mcp-hubspot：

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 许可证的许可。