HubSpot MCP服务器

概述

这是一个模型上下文协议（MCP）服务器，使AI助手能够与HubSpot CRM数据交互。该服务器充当AI模型与您的HubSpot账户之间的桥梁，提供对联系人、公司和互动数据的直接访问。内置的向量存储和缓存机制有助于克服HubSpot API的限制，同时提高响应速度。

我们的实现优先考虑最常用、高价值的HubSpot操作，并具备强大的错误处理能力和API稳定性。每个组件都针对AI友好型交互进行了优化，即使在复杂的、多步骤的CRM工作流中也能确保可靠的性能。

为什么选择MCP-HubSpot？

• 直接CRM访问：无需中间步骤即可将Claude和其他AI助手连接到您的HubSpot数据
• 上下文保留：采用FAISS的向量存储支持对先前互动进行语义搜索
• 零配置：简单的Docker部署，设置最少

示例提示

从这个LinkedIn个人资料创建HubSpot联系人和公司：
[粘贴LinkedIn个人资料文本]

我的销售漏斗最近有什么动态？

可用工具

该服务器提供用于HubSpot管理和数据检索的工具：

性能特性

• 向量存储：利用FAISS实现高效的语义搜索和检索
• 线程级索引：单独存储每个对话线程以实现精确检索
• 嵌入缓存：使用SentenceTransformer并自动缓存
• 持久化存储：数据在可配置的存储目录中跨会话保留
• 多平台支持：针对各种架构优化的Docker镜像

设置

前提条件

您需要一个具有以下权限范围的HubSpot访问令牌：

• crm.objects.contacts（读/写）
• crm.objects.companies（读/写）
• sales-email-read

快速开始

# 通过Smithery安装（推荐）
npx -y @smithery/cli@latest install mcp-hubspot --client claude

# 或直接拉取Docker镜像
docker run -e HUBSPOT_ACCESS_TOKEN=your_token buryhuang/mcp-hubspot:latest

Docker配置

在Claude桌面版中进行手动配置：

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
        "-v", "/path/to/storage:/storage",  # 可选持久化存储
        "buryhuang/mcp-hubspot:latest"
      ]
    }
  }
}

构建Docker镜像

在本地构建Docker镜像：

git clone https://github.com/buryhuang/mcp-hubspot.git
cd mcp-hubspot
docker build -t mcp-hubspot .

对于多平台构建：

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

开发

pip install -e .

许可证

MIT许可证