Skip to main content
Glama
deenesjakoruzh
Kai8karma

gtmos-mcp

by Kai8karma
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

gtmos-mcp

只读的 CRM 审计工具，适用于 Claude：通过你自己的令牌，在你的环境中对数据完整性评分、查找重复集群和停滞收入。

一个基于 MCP（模型上下文协议）的服务器，让 Claude Desktop、Claude Code 或任何 MCP 主机能够审计你的 HubSpot CRM。它在你的环境中运行，使用你自己的 HubSpot 令牌读取数据，没有任何新的供应商接触你的数据。每个工具本质上都是只读的：此包不会向 CRM 写入任何内容、发送邮件或调用除你自己 HubSpot 端点之外的任何网络 API。

  • 零依赖。 纯 Python 标准库（dependencies = []）。无需传递审核。

  • 只读。 两个工具，均为审计功能。你的令牌不需要任何写入作用域。

  • 确定性评分。 评分路径中不包含 LLM；模型仅读取结果，而不自行生成结果。

  • 可离线运行。 将工具指向一个 JSON 导出文件而不是实时门户，则完全不会发生网络调用。

工具

工具

功能

audit_crm

对联系人进行数据完整性漏洞评分：完整性、有效性、新鲜度、所有权、一致性。返回门户完整性评分、等级、重复集群以及最薄弱的维度。输出一份完整的 Markdown 报告。

funnel_leak

按阶段分析交易，以发现停滞的管道以及收入从漏斗中泄漏的位置。返回泄漏的美元总额以及导致泄漏的停滞交易。

Related MCP server: g-gremlin-hubspot-mcp

安装

需要 Python 3.11+。

pip install git+https://github.com/Kai8karma/gtmos-mcp.git

验证：

gtmos mcp --dry-run

预期输出：

[dry-run] gtmos mcp would serve 2 tools on stdio (protocol 2025-06-18)
  - audit_crm: Score a CRM export or live HubSpot portal for data-integrity leaks.
  - funnel_leak: Analyse deals by stage to find stalled pipeline and where revenue leaks out of the funnel.

连接到 Claude

生成配置块（始终与已安装的代码匹配）：

gtmos mcp --config

然后将其粘贴到你的 MCP 主机配置中。对于 Claude Desktop，该文件位于 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

{
  "mcpServers": {
    "gtmos": {
      "command": "gtmos",
      "args": [
        "mcp"
      ],
      "env": {
        "GTMOS_HUBSPOT_TOKEN": "<your-hubspot-private-app-token>"
      }
    }
  }
}

对于 Claude Code：

claude mcp add gtmos --env GTMOS_HUBSPOT_TOKEN=<your-hubspot-private-app-token> -- gtmos mcp

重启主机，然后询问：“审计我的 CRM 并显示最薄弱的维度。”

获取 HubSpot 令牌

在你的 HubSpot 门户中创建一个具有只读作用域的私有应用：crm.objects.contacts.read 用于 audit_crm，crm.objects.deals.read 用于 funnel_leak。令牌保留在你机器上的主机配置中；此包从不存储或转发它。

没有令牌？使用导出文件

两个工具都接受文件而不是实时门户：

audit_crm  { "contacts_file": "./contacts.json", "acv": 9000 }
funnel_leak { "deals_file": "./deals.json" }

contacts.json 是一个联系人对象的 JSON 数组（HubSpot 导出格式：properties.email、properties.firstname，……）。请参见 tests/fixtures/contacts_sample.json 和 tests/fixtures/deals_sample.json 了解具体格式。

运行示例

Scored 25 records.
Portal integrity score: 77.5 (B).
Duplicate clusters found: 2.
Dimension averages (worst first):
  - freshness: 55.0
  - ownership: 88.0
  - validity: 91.9
  - consistency: 93.6
  - completeness: 94.6
Full report written to: ./audit-out/integrity-report.md

无 MCP 的命令行界面

相同的引擎可直接从 shell 运行：

gtmos audit --input contacts.json --acv 9000     # contact integrity audit
gtmos calibrate --scores s.json --outcomes o.json # grade the scorer against real outcomes

架构

基于换行符分隔的 JSON-RPC 2.0 通过标准输入/输出，遵循 MCP stdio 传输。协议处理程序（handle_message）是一个纯函数，输入消息，输出响应，因此整个表面无需启动进程即可测试。评分引擎是确定性的且无网络依赖；唯一的网络代码是可选的 HubSpot 获取操作，使用你的令牌，从你的机器上运行。

gtmos/
  mcp/        stdio server + tool definitions
  audit/      contact integrity engine, fetch, report
  funnel/     deal-stage leak engine, fetch, report
  calibrate/  scorer-vs-reality grading

测试

python -m pytest tests/

59 个测试，全部离线运行，无需令牌。

许可证

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • g-gremlin-hubspot-mcp

    mikeheilmann1024
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables advanced HubSpot CRM operations including unlimited record extraction, duplicate detection and merging, property drift analysis, and bulk upserts, surpassing official API limits.
    MIT

  • MCP Suite CRM

    rehanhaider
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to interact with a CRM covering companies, people, leads, deals, and more, with role checks, scoped agent keys, approval gates, and a shared audit trail.
    AGPL 3.0