HubSpot MCP Server

概述

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

我们的实现优先考虑最常用且高价值的HubSpot操作，并具有强大的错误处理和API稳定性。每个组件都经过优化以支持AI友好的交互，确保即使在复杂的多步骤CRM工作流程中也能保持可靠性能。

为什么选择MCP-HubSpot？

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

示例提示

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

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

可用工具

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

工具	目的
hubspot_create_contact	创建联系人时防止重复
hubspot_create_company	创建公司时防止重复
hubspot_get_company_activity	获取特定公司的活动
hubspot_get_active_companies	获取最近活跃的公司
hubspot_get_active_contacts	获取最近活跃的联系人
hubspot_get_recent_conversations	获取带有消息的最近对话线程
hubspot_search_data	在之前检索的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 m_ hubspot .

多平台构建：

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

开发

pip install -e .

许可证

MIT许可证