MCP Hubspot

🚀 虎牙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管理和數據檢索的工具：

性能特點

• 向量存儲：利用FAISS實現高效的語義搜索和檢索。
• 線程級索引：每個會話單獨存儲，確保精確檢索。
• 嵌入緩存：使用SentenceTransformer並自動緩存。
• 持久化存儲：數據在配置的存儲目錄之間持久化。
• 多平臺支持：針對各種架構優化了Docker鏡像。

📄 許可證

本項目採用 MIT 許可證。