🚀 强大的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