HubSpot MCP服务器

这是一个强大的模型上下文协议（MCP）服务器实现，专为无缝集成HubSpot CRM而设计，使AI助手能够与您的HubSpot数据进行交互。

概述

该MCP服务器提供了一套全面的工具来与HubSpot CRM API进行交互，使AI助手能够：

• 在您的HubSpot CRM中创建和管理联系人和公司
• 获取详细的公司活动历史和互动时间线
• 访问整个HubSpot实例中的近期互动数据
• 获取最近活跃的公司和联系人列表
• 在不离开AI助手界面的情况下执行CRM操作

为什么使用这个MCP服务器？

• 无缝AI集成：直接将您的AI助手连接到HubSpot CRM数据
• 简化的CRM操作：通过自然语言命令执行常见的HubSpot任务
• 实时数据访问：从您的HubSpot实例获取最新信息
• 安全认证：使用HubSpot的安全API令牌认证
• 可扩展的设计：根据需要轻松添加更多HubSpot API功能

安装

# 克隆仓库
git clone https://github.com/lkm1developer/hubspot-mcp-server.git
cd hubspot-mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

配置

服务器需要一个HubSpot API访问令牌。您可以通过以下方式获取：

1. 访问您的HubSpot开发者账户
2. 创建一个具有必要范围（联系人、公司、互动）的私有应用
3. 复制生成的访问令牌

您可以通过两种方式提供令牌：

1. 作为环境变量：

   HUBSPOT_ACCESS_TOKEN=your-access-token
   

2. 作为命令行参数：

   npm start -- --access-token=your-access-token
   

对于开发，可以在项目根目录创建一个.env文件来存储您的环境变量：

HUBSPOT_ACCESS_TOKEN=your-access-token

使用

启动服务器

# 启动服务器
npm start

# 或者使用特定的访问令牌
npm start -- --access-token=your-access-token

# 运行带有认证的SSE服务器
npx mcp-proxy-auth node dist/index.js

在SSE服务器中实现认证

SSE服务器使用mcp-proxy-auth包进行认证。要实现认证：

1. 安装包：

   npm install mcp-proxy-auth
   

2. 设置AUTH_SERVER_URL环境变量以指向您的API密钥验证端点：

   export AUTH_SERVER_URL=https://your-auth-server.com/verify
   

3. 运行带有认证的SSE服务器：

   npx mcp-proxy-auth node dist/index.js
   

4. SSE URL将在以下位置可用：

   localhost:8080/sse?apiKey=apikey
   

   将apikey替换为您的实际API密钥以进行认证。

mcp-proxy-auth包充当代理，它：

• 拦截对您的SSE服务器的请求
• 根据您的认证服务器验证API密钥
• 只允许经过认证的请求到达您的SSE端点

与AI助手集成

此MCP服务器旨在与支持模型上下文协议的AI助手一起工作。一旦运行，服务器会公开一组工具，兼容的AI助手可以使用这些工具与您的HubSpot CRM数据进行交互。

可用工具

服务器公开了以下强大的HubSpot集成工具：

1. hubspot_create_contact

   • 在HubSpot中创建新联系人并进行重复检查
   • 参数：
     • firstname（字符串，必需）：联系人的名字
     • lastname（字符串，必需）：联系人的姓氏
     • email（字符串，可选）：联系人的电子邮件地址
     • properties（对象，可选）：其他联系人属性，如公司、电话等
   • 示例：

     {
       "firstname": "John",
       "lastname": "Doe",
       "email": "john.doe@example.com",
       "properties": {
         "company": "Acme Inc",
         "phone": "555-123-4567",
         "jobtitle": "Software Engineer"
       }
     }
     

2. hubspot_create_company

   • 在HubSpot中创建新公司并进行重复检查
   • 参数：
     • name（字符串，必需）：公司名称
     • properties（对象，可选）：其他公司属性
   • 示例：

     {
       "name": "Acme Corporation",
       "properties": {
         "domain": "acme.com",
         "industry": "Technology",
         "phone": "555-987-6543",
         "city": "San Francisco",
         "state": "CA"
       }
     }
     

3. hubspot_get_company_activity

   • 获取特定公司的综合活动历史
   • 参数：
     • company_id（字符串，必需）：HubSpot公司ID
   • 返回包含电子邮件、电话、会议、笔记和任务的详细互动数据

4. hubspot_get_recent_engagements

   • 获取所有联系人和公司的近期互动活动
   • 参数：
     • days（数字，可选，默认：7）：回顾的天数
     • limit（数字，可选，默认：50）：返回的最大互动数
   • 返回按时间顺序排列的所有近期CRM活动列表

5. hubspot_get_active_companies

   • 从HubSpot获取最近活跃的公司
   • 参数：
     • limit（数字，可选，默认：10）：返回的最大公司数
   • 返回按最后修改日期排序的公司

6. hubspot_get_active_contacts

   • 从HubSpot获取最近活跃的联系人
   • 参数：
     • limit（数字，可选，默认：10）：返回的最大联系人数
   • 返回按最后修改日期排序的联系人

7. hubspot_update_contact

   • 更新HubSpot中现有的联系人（如果联系人不存在则忽略）
   • 参数：
     • contact_id（字符串，必需）：要更新的HubSpot联系人ID
     • properties（对象，必需）：要更新的联系人属性
   • 示例：

     {
       "contact_id": "12345",
       "properties": {
         "email": "updated.email@example.com",
         "phone": "555-987-6543",
         "jobtitle": "Senior Software Engineer"
       }
     }
     

8. hubspot_update_company

   • 更新HubSpot中现有的公司（如果公司不存在则忽略）
   • 参数：
     • company_id（字符串，必需）：要更新的HubSpot公司ID
     • properties（对象，必需）：要更新的公司属性
   • 示例：

     {
       "company_id": "67890",
       "properties": {
         "domain": "updated-domain.com",
         "phone": "555-123-4567",
         "industry": "Software",
         "city": "New York",
         "state": "NY"
       }
     }
     

扩展服务器

该服务器设计为易于扩展。要添加新的HubSpot API功能：

1. 在src/hubspot-client.ts中的HubSpotClient类中添加新方法
2. 在src/index.ts中的setupToolHandlers方法中注册新工具
3. 使用npm run build重新构建项目

许可证

该项目根据MIT许可证授权 - 详情请参阅LICENSE文件。

关键词

HubSpot, CRM, 模型上下文协议, MCP, AI助手, TypeScript, API集成, HubSpot API, CRM集成, 联系人管理, 公司管理, 互动跟踪, AI工具