Hubspot MCP Server

🚀 用於與 HubSpot CRM 系統交互的 Model Context Protocol (MCP) 服務器

這是一個專門用於與 HubSpot CRM 系統交互的 MCP 服務器。它提供了豐富的功能，可創建和更新聯繫人及公司信息，還能獲取活動歷史記錄與最近的互動數據，為用戶管理 CRM 系統提供了便利。

🚀 快速開始

本 MCP 服務器可幫助你高效地與 HubSpot CRM 系統進行交互，實現聯繫人與公司信息的管理、活動記錄查詢等功能。

✨ 主要特性

• TypeScript 開發：運用現代 TypeScript 語言編寫，保證代碼清晰且具備類型安全。
• 異步操作：藉助承諾達成非阻塞 IO 操作，有效提升性能。
• 模塊化設計：採用模塊化結構，便於對系統進行擴展和維護。
• 全面的文檔支持：提供詳盡的 API 文檔與使用說明。

📦 安裝指南

1. 克隆項目倉庫：

   git clone <repository-url>
   cd hubspot-mcp-server
   

2. 安裝依賴項：

   npm install
   

💻 使用示例

基礎用法

聯繫人管理

• 創建聯繫人：

  npm run create-contact -- [姓名] [郵箱]
  

• 更新聯繫人信息：

  npm run update-contact -- [聯繫人ID] [屬性]
  

公司管理

• 創建公司：

  npm run create-company -- [公司名稱]
  

• 更新公司信息：

  npm run update-company -- [公司ID] [屬性]
  

活動記錄查詢

• 獲取特定公司的活動歷史：

  npm run get-company-activity -- [公司ID]
  

• 查看最近互動：

  npm run get-recent-engagements -- [--天數=7] [--限制=50]
  

高級用法

若你需要對系統進行擴展或自定義日誌輸出，可參考以下內容：

• 新增功能：通過擴展 HubSpotClient 類並在 setupToolHandlers 方法中註冊新工具，能夠輕鬆添加更多 HubSpot API 功能。
• 自定義日誌：根據實際需求修改日誌記錄級別，實現更詳細的調試信息輸出。

📚 詳細文檔

配置說明

• 環境變量：需要設置 HUBSPOT_API_KEY 環境變量，以確保服務器能夠連接到 HubSpot API。

常見問題

1. 如何獲取 API 密鑰？
   • 登錄 HubSpot 賬戶，在設置中找到開發者工具，生成新的 API 密鑰。
2. 服務器無法啟動怎麼辦？
   • 檢查環境變量是否正確設置，並確保網絡連接正常。

📄 許可證

本項目遵循 MIT 許可證，具體內容請參見 LICENSE 文件。