HubSpot MCP Server專案

MCP工具

HubSpot MCP Server專案

mcp-hubspot 是一個專為模型內容協定 (Model Context Protocol, MCP) 設計的伺服器，其核心目標是讓 AI 助理（如 Claude）能夠直接與 HubSpot CRM 系統進行互動和數據交換。

這個專案不僅僅是簡單地連接 AI 與 HubSpot API，它最大的亮點在於其內建的進階效能優化機制，包括向量儲存 (Vector Storage) 和快取 (Caching)。這些設計旨在克服 HubSpot API 本身的限制，同時大幅提升 AI 的回應速度和互動品質。

核心價值：將你的 AI 助理升級為有記憶、高效率的 CRM 專家

傳統的 API 連接是「一次性」的，AI 無法記住之前的查詢結果。mcp-hubspot 透過以下技術徹底改變了這一點：

• 向量儲存與語意搜尋 (Semantic Search):

  • 使用 FAISS（一個由 Facebook 開發的高效相似性搜尋函式庫），將你的 CRM 數據和對話內容轉換為向量並儲存起來。
  • 這使得 AI 具備了上下文記憶能力。你可以用模糊的、口語化的方式提問（例如：「最近和我聯絡比較頻繁的客戶有哪些？」），AI 能夠理解你的意圖，並在你的 CRM 數據中進行基於「意義」而非「精確關鍵字」的搜尋。

• 快取機制 (Caching):

  • 自動快取常用的數據和嵌入 (Embeddings)，避免了對 HubSpot API 的重複請求，不僅節省了 API 配額，也讓後續的查詢回應更快。

主要功能與工具

此專案提供了一系列針對高價值 CRM 操作的最佳化工具：

• 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: 核心功能，允許 AI 在所有先前檢索過的 HubSpot 數據中進行高效的語意搜尋。

安裝與設定

專案的部署非常簡單，主打零配置 (Zero Configuration)：

1. 前提: 你需要一個 HubSpot 帳戶，並產生一個具有 crm.objects.contacts、crm.objects.companies 等必要權限的存取權杖 (Access Token)。
2. 安裝: 推薦使用 Smithery 進行一鍵安裝，或者直接透過 Docker 部署。
3. 設定: 啟動 Docker 容器時，只需將你的 HubSpot Access Token 作為環境變數 HUBSPOT_ACCESS_TOKEN 傳入即可。你還可以選擇性地掛載一個本地目錄到容器的 /storage 路徑，以實現向量數據和快取的持久化儲存。

總結來說，mcp-hubspot 是一個為專業銷售、行銷和客戶關係管理人員設計的強大 MCP 伺服器。它不僅打通了 AI 與 CRM 之間的數據壁壘，更透過先進的向量儲存和快取技術，讓 AI 成為一個真正能夠理解上下文、具備長期記憶、並且反應迅速的智慧 CRM 助理。

• MCP平台來源: github
• 連結: https://github.com/peakmojo/mcp-hubspot

立即試用MCP工具