AI导哈

HubSpot MCP服务器

一个提供访问HubSpot API的模型上下文协议服务器，使LLM能够与HubSpot的联系人、交易和互动数据进行交互。

  • by isaacraja
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 isaacraja/hubspot-mcp-server

使用说明

HubSpot MCP服务器

模型上下文协议服务器，提供对HubSpot API的访问。此服务器使LLM能够与HubSpot联系人、交易和参与数据进行交互。 模型上下文协议服务器，提供对HubSpot API的访问。此服务器使LLM能够与HubSpot联系人、交易和接洽进行交互。

组件

工具

服务器实现了几个用于HubSpot交互的工具：

联系工具

  • get_contact_by_id：通过联系人的HubSpot ID检索联系人（支持字符串和整数ID）
  • get_contact_by_email：通过电子邮件地址查找联系人
  • search_contacts：根据房产条件搜索联系人

交易工具

  • get_deal_by_id：通过HubSpot ID检索交易
  • get_contact_deals：获取与联系人相关的所有交易
  • get_deal_contacts：获取与交易相关的所有联系人

参与工具

  • get_latest_marketing_campaign：获取有关最近营销活动的信息
  • get_campaign_engagement：获取参与特定活动的联系人
  • get_page_visits：获取访问特定页面的联系人
  • get_contact_analytics：获取特定联系人的分析数据
  • get_scheduled_meetings：在一段时间内安排会议
  • get_meeting_details：获取特定会议的详细信息

资源

  • hubspot://contacts/schema：关于联系人对象结构的信息
  • hubspot://deals/schema：有关交易对象结构的信息

配置

服务器需要以下环境变量：

  • HUBSPOT_API_KEY （必需）：您的HubSpot API密钥

快速启动

安装

uv pip install hubspot-mcp-server

Claude桌面配置

将此添加到您的Claude Desktop配置文件中：

在MacOS上： ~/Library/Application\ Support/Claude/claude_desktop_config.json 在Windows上： %APPDATA%/Claude/claude_desktop_config.json

通过Smithery安装

通过以下方式自动安装适用于Claude Desktop的HubSpot MCP服务器 史密瑟里:

npx -y @smithery/cli install @isaacraja/hubspot-mcp-server --client claude
开发配置
"mcpServers": {
  "hubspot": {
    "command": "uv",
    "env": {
      "HUBSPOT_API_KEY": "your_hubspot_api_key"
    },
    "args": [
      "--directory",
      "{{PATH_TO_REPO}}",
      "run",
      "hubspot-mcp-server"
    ]
  }
}

替换 {{PATH_TO_REPO}} 带有克隆存储库的路径，以及 your_hubspot_api_key 使用您的实际HubSpot API密钥。

开发/未发布的服务器配置

{
  "mcpServers": {
    "hubspot-mcp-server": {
      "command": "uv",
      "env": {
        "HUBSPOT_API_KEY": "your-api-key"
      },
      "args": [
        "--directory",
        "{{PATH_TO_REPO}}/src/hubspot_mcp_server",
        "run",
        "server.py"
      ]
    }
  }
}

已发布的服务器配置

{
  "mcpServers": {
    "hubspot-mcp-server": {
      "command": "uvx",
      "env": {
        "HUBSPOT_API_KEY": "your-api-key"
      },
      "args": [
        "hubspot-mcp-server"
      ]
    }
  }
}

替换 your-api-key 使用HubSpot API密钥。

发展

建筑与出版

  1. 同步依赖关系并更新锁文件：
uv sync
  1. 构建包分发：
uv build

这将在 dist/ 目录。

  1. 发布到PyPI：
uv publish

注意：您需要通过环境变量或命令标志设置PyPI凭据：

  • 令牌： --token 或 UV_PUBLISH_TOKEN
  • 或用户名/密码： --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

测试

安装测试依赖项：

uv sync --extra test

运行测试：

# Run all tests
pytest

# Run with coverage
pytest --cov=server

调试

由于MCP服务器在stdio上运行，调试可能具有挑战性。为了获得最佳的调试体验，我们建议使用 MCP检查员.

您可以通过以下方式启动MCP检查器 npm 使用此命令：

npx @modelcontextprotocol/inspector uv --directory {{PATH_TO_REPO}} run hubspot-mcp-server

启动后，检查器将显示一个URL，您可以在浏览器中访问该URL以开始调试。

许可证

麻省理工学院

相关 MCP