金大哥 - lkm1developer_hubspot-mcp-server MCP 详情

article

README

🚀 强大的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功能，请按照以下步骤操作：

在src/hubspot-client.ts中向HubSpotClient类添加新方法。
在src/index.ts的setupToolHandlers方法中注册新工具。
使用命令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

lkm1developer_hubspot-mcp-server