项目简介

该项目是一个用TypeScript编写的强大MCP（Model Context Protocol）服务器实现，专为与HubSpot CRM集成而设计。它的主要目的是使AI助手能够与HubSpot的数据进行交互。

安装和配置

1. 克隆仓库：

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

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 配置：

   • 使用环境变量：

     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"]

工具功能

以下是服务器支持的工具及其详细说明：

1. 创建公司：

   {
     toolName: 'hubspot_create_company',
     parameters: {
       name: string,
       properties?: object
     }
   }
   

2. 获取公司活动记录：

   {
     toolName: 'hubspot_get_company_activity',
     parameters: {
       companyId: string
     }
   }
   

3. 获取最近的互动记录：

   {
     toolName: 'hubspot_get_recent_engagements',
     parameters: {
       days?: number,
       limit?: number
     }
   }
   

4. 获取最活跃的公司：

   {
     toolName: 'hubspot_get_active_companies',
     parameters: {
       limit?: number
     }
   }
   

5. 获取最活跃的联系人：

   {
     toolName: 'hubspot_get_active_contacts',
     parameters: {
       limit?: number
     }
   }
   

6. 更新联系人信息：

   {
     toolName: 'hubspot_update_contact',
     parameters: {
       contactId: string,
       properties: object
     }
   }
   

7. 更新公司信息：

   {
     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