JinDaGe - mcp-hubspot MCP Details

article

README

🚀 虎牙HubSpot MCP服务器

本项目是一个模型上下文协议（MCP）服务器，可让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镜像

要在本地构建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,linux/arm/v7 .

✨ 主要特性

直接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镜像。

📄 许可证

本项目采用 MIT 许可证。

mcp-hubspot