星战科技xingzhan.cloud
返回市场
霍布斯波特-MCP服务器

霍布斯波特-MCP服务器

作者：lkm1developer13 星标更新：2025-04-01
安装使用来源：spider==github.com

项目介绍

HubSpot MCP Server

TypeScript HubSpot API MCP SDK License: MIT

一个强大的模型上下文协议（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": "软件工程师"
  }
}

  2. hubspot_create_company

    • 在HubSpot中创建一个新的公司，并检查重复项
    • 参数：
      • name（字符串，必需）：公司名称
      • properties（对象，可选）：额外的公司属性
    • 示例： 例如： 
      {
  "name": "Acme Corporation",
  "properties": {
    "domain": "acme.com",
    "industry": "科技",
    "phone": "555-987-6543",
    "city": "旧金山",
    "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": "高级软件工程师"
  }
}

  8. hubspot_update_company

    • 更新HubSpot中的现有公司（如果公司不存在则忽略）
    • 参数：
      • company_id（字符串，必需）：要更新的HubSpot公司ID
      • properties（对象，必需）：要更新的公司属性
    • 示例： 
      {
  "company_id": "67890",
  "properties": {
    "domain": "updated-domain.com",
    "phone": "555-123-4567",
    "industry": "软件",
    "city": "纽约",
    "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工具