项目简介

这是一个用于与 HubSpot CRM 系统交互的 Model Context Protocol (MCP) 服务器。该服务器提供了多种功能，包括创建和更新联系人及公司信息、获取活动历史记录以及最近的互动数据等。

特性

• TypeScript 开发：使用现代 TypeScript 语言编写，确保代码清晰和类型安全。
• 异步操作：通过承诺实现非阻塞 IO 操作，提升性能。
• 模块化设计：采用模块化结构，便于扩展和维护。
• 全面的文档支持：提供详细的 API 文档和使用说明。

安装指南

1. 克隆项目仓库：

   git clone <repository-url>
   cd hubspot-mcp-server
   

2. 安装依赖项：
 ```bash
 npm install

配置说明

• 环境变量：需要设置 HUBSPOT_API_KEY 环境变量，确保服务器能够连接到 HubSpot API。

使用方法

联系人管理

1. 创建联系人：

   npm run create-contact -- [姓名] [邮箱]
   

2. 更新联系人信息：
 ```bash
 npm run update-contact -- [联系人ID] [属性]

公司管理

1. 创建公司：

   npm run create-company -- [公司名称]
   

2. 更新公司信息：
 ```bash
 npm run update-company -- [公司ID] [属性]

活动记录查询

1. 获取特定公司的活动历史：

   npm run get-company-activity -- [公司ID]
   

2. 查看最近互动：
 ```bash
 npm run get-recent-engagements -- [--天数=7] [--限制=50]

常见问题

1. 如何获取 API 密钥？

   • 登录 HubSpot 账户，在设置中找到开发者工具，生成新的 API 密钥。

2. 服务器无法启动怎么办？

   • 检查环境变量是否正确设置，并确保网络连接正常。

扩展说明

1. 新增功能：通过扩展 HubSpotClient 类和在 setupToolHandlers 方法中注册新工具，可以轻松添加更多 HubSpot API 功能。
2. 自定义日志：根据需要修改日志记录级别，实现更详细的调试信息输出。

许可证

本项目遵循 MIT 许可证，具体内容请参见 LICENSE 文件。

关键词

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