Lkm1developer Hubspot MCP Server

🚀 強大的HubSpot MCP服務器項目

該項目是一個用TypeScript編寫的強大MCP（Model Context Protocol）服務器實現，專為與HubSpot CRM集成而設計。其主要價值在於讓AI助手能夠與HubSpot的數據進行交互，極大提升了數據的利用效率和業務流程的自動化程度。

🚀 快速開始

本項目是一個用TypeScript編寫的強大MCP（Model Context Protocol）服務器實現，專為與HubSpot CRM集成而設計，能讓AI助手與HubSpot的數據進行交互。

📦 安裝指南

克隆倉庫

git clone https://github.com/yourusername/hubspot-mcp-server.git
cd hubspot-mcp-server

安裝依賴項

npm install

構建項目

npm run build

配置

• 使用環境變量：

HUBSPOT_API_KEY=your_api_key_here

• 或者使用命令行參數啟動服務器時指定API密鑰：

npm start -- --apiKey your_api_key_here

💻 使用示例

服務器運行

本地運行

npm run dev

生產環境運行

npm start

Docker部署

# Dockerfile
FROM node:16

WORKDIR /app

COPY package*.json ./

RUN npm install

COPY . .

CMD ["node", "dist/index.js"]

工具功能使用

基礎用法

以下是服務器支持的工具及其詳細說明：

// 創建公司
{
  toolName: 'hubspot_create_company',
  parameters: {
    name: string,
    properties?: object
  }
}

// 獲取公司活動記錄
{
  toolName: 'hubspot_get_company_activity',
  parameters: {
    companyId: string
  }
}

// 獲取最近的互動記錄
{
  toolName: 'hubspot_get_recent_engagements',
  parameters: {
    days?: number,
    limit?: number
  }
}

// 獲取最活躍的公司
{
  toolName: 'hubspot_get_active_companies',
  parameters: {
    limit?: number
  }
}

// 獲取最活躍的聯繫人
{
  toolName: 'hubspot_get_active_contacts',
  parameters: {
    limit?: number
  }
}

// 更新聯繫人信息
{
  toolName: 'hubspot_update_contact',
  parameters: {
    contactId: string,
    properties: object
  }
}

// 更新公司信息
{
  toolName: 'hubspot_update_company',
  parameters: {
    companyId: string,
    properties: object
  }
}

📚 詳細文檔

擴展服務器

要添加新的HubSpot API功能，請按照以下步驟操作：

1. 在src/hubspot-client.ts中向HubSpotClient類添加新方法。
2. 在src/index.ts的setupToolHandlers方法中註冊新工具。
3. 使用命令npm run build重新構建項目。

📄 許可證

該項目使用MIT許可證，具體細節請參見LICENSE文件。

關鍵字

HubSpot, CRM, Model Context Protocol, MCP, AI Assistant, TypeScript, API Integration, HubSpot API, CRM Integration, Contact Management, Company Management, Engagement Tracking, AI Tools