JinDaGe - hubspot-mcp-server MCP Details

article

README

🚀 埋华 HubSpot MCP 服务器

本项目是一个模型上下文协议（MCP）服务器，可让 AI 助手与 HubSpot CRM 数据进行交互。它将 AI 模型与您的 HubSpot 账户相连，能直接访问联系人、公司和互动数据。内置的向量存储和缓存机制，不仅克服了 HubSpot API 的限制，还提升了响应速度。

🚀 快速开始

本服务器可使 AI 助手与 HubSpot CRM 数据交互，将 AI 模型与您的 HubSpot 账户连接，提供对联系人、公司和互动数据的直接访问。内置向量存储和缓存机制，克服了 HubSpot API 的限制，提高了响应速度。

安装先决条件

您需要具有以下权限的 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 镜像

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

使用说明

运行服务器：通过 Docker 容器运行 MCP 服务器：

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

连接到客户端：在您的应用程序中使用 HubSpot 客户端库进行连接。

✨ 主要特性

直接 CRM 访问：将 Claude 和其他 AI 助手连接到您的 HubSpot 数据，无需中间步骤。
上下文保留：使用 FAISS 进行语义搜索以跨越先前互动的上下文。
零配置：简单的 Docker 部署，设置最少。
性能特性：
- 向量存储：使用 FAISS 进行高效语义搜索和检索。
- 线程级索引：每个会话单独存储以实现精确检索。
- 嵌入缓存：使用 SentenceTransformer 并带有自动缓存。
- 持久存储：数据在配置存储目录之间保持会话。
- 多平台支持：优化的 Docker 映像适用于各种架构。

💻 使用示例

示例提示

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

我最新的.pipeline 中发生了什么事情？

📚 详细文档

可用工具

该服务器提供以下用于 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 数据上进行语义搜索 |

📄 许可证

该软件受 MIT 许可证的保护。请参阅 LICENSE 文件以获取详细信息。

hubspot-mcp-server