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 功能

安装

# Clone the repository
git clone https://github.com/lkm1developer/hubspot-mcp-server.git
cd hubspot-mcp-server

# Install dependencies
npm install

# Build the project
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

使用

启动服务器

# Start the server
npm start

# Or with a specific access token
npm start -- --access-token=your-access-token

# Run the SSE server with authentication
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 服务器设计用于支持模型上下文协议 (Model Context Protocol) 的 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): 返回的最大联系人数量
   • 返回按最后修改日期排序的联系人

扩展服务器

该服务器设计为易于扩展。要添加新的 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 助手, TypeScript, API 集成, HubSpot API, CRM 集成, 联系人管理, 公司管理, 参与跟踪, AI 工具