OpenClaw FinOps

IntegrityPulse FinOps

阻止 AI Agent 幻觉云成本。在对话中获取真实的价格预测。

---

这是什么？

IntegrityPulse FinOps 是一个远程 MCP 服务，可为 AI 编码 Agent 提供准确、实时的云部署成本预测。它不会让 Agent 猜测“一个 EC2 实例每月大约需要 50 美元”，而是调用由经过验证的价格矩阵支持的工具，并返回逐项明细。

一个工具。三家云服务商。杜绝幻觉。

User: "What would it cost to run our API on AWS with an m5.large, a managed Postgres, and Redis?"

Agent (via IntegrityPulse FinOps):
  | Service                    | Category | Hours | Est. Cost |
  |----------------------------|----------|-------|-----------|
  | m5.large                   | Compute  | 730   | $70.08    |
  | rds.postgres.db.m5.large   | Database | 730   | $204.40   |
  | elasticache.redis.t3.micro | Cache    | 730   | $11.68    |

  Total Estimated Monthly Cost: $286.16

---

快速开始

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "integritypulse": {
      "type": "streamable-http",
      "url": "https://integritypulse.marywomack.workers.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

添加到你的 .cursor/mcp.json：

{
  "mcpServers": {
    "integritypulse": {
      "type": "streamable-http",
      "url": "https://integritypulse.marywomack.workers.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

cURL

curl -X POST https://integritypulse.marywomack.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "forecast_deployment_cost",
      "arguments": {
        "provider": "AWS",
        "services_to_add": [
          {"service_name": "m5.large", "estimated_usage_hours": 730}
        ]
      }
    }
  }'

---

工具：forecast_deployment_cost

参数	类型	描述
provider	"AWS" | "GCP" | "AZURE"	要查询价格的云服务商
services_to_add	Array<{ service_name, estimated_usage_hours }>	要纳入预测的服务

支持的服务：

AWS	GCP	Azure
t3.micro, t3.medium, m5.large	e2-micro, e2-medium, n2-standard-2	B1s, B2s, D2s_v3
rds.postgres.db.t3.micro, rds.postgres.db.m5.large	cloudsql.postgres.db-custom-1-3840, cloudsql.postgres.db-custom-4-15360	postgresql.flexible.b1ms
elasticache.redis.t3.micro	memorystore.redis.1gb
s3.standard.1tb

---

存在的原因：面向 Agent 时代的 FinOps

AI Agent 正从“给我写代码”迈向“替我部署”。当 Agent 配置基础设施时，成本准确性不是可有可无的功能，而是一项财务控制措施。

问题： 大模型会产生价格幻觉。它们会信誓旦旦地告诉你，一个 RDS 实例每月只需“15 美元”，而实际金额却是 204 美元。当 Agent 开始自主执行部署时，这些幻觉就会变成真实账单。

解决方案： IntegrityPulse FinOps 是 Agent 可调用的有据可依的定价预言机。价格矩阵经过维护、版本化，且结果确定。不生成、不猜测。

Agent 商务与收入门槛

此服务也是收入门控型 MCP的参考实现——这是一种在不破坏 Agent 体验的前提下，将 MCP 工具变现的模式。

工作方式如下：

1. 每个请求都带有 x-api-key 标头。
2. 服务会在 Supabase 中检查用户的 tier 和 monthly_usage_count。
3. 免费版用户每月可进行 25 次操作。
4. 达到限额时，服务不会返回 HTTP 错误，而是返回有效的 MCP 工具结果，并设置 isError: true：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{
      "type": "text",
      "text": "IntegrityPulse FinOps Alert: Your free monthly tier (25/25 operations) has been exhausted. To generate this architectural cost forecast, please upgrade to the Pro tier here: https://billing.openclaw.com/upgrade. Once upgraded, ask me to retry."
    }],
    "isError": true
  }
}

为什么使用 isError: true，而不是 HTTP 402/429？

因为调用方是大模型，而不是浏览器。HTTP 错误会被 MCP 传输层吞掉，用户根本看不到。返回带有 isError: true 的工具结果，升级提示就会直接出现在用户正在参与的对话中。Agent 会读取并展示提示，用户可以立即采取行动。这是在用户意图产生时促成交易。

Stripe 集成

用户通过账单链接升级后，Stripe 会向 /api/webhook/stripe 发送 checkout.session.completed webhook。服务会自动：

• 将用户的套餐从 FREE 更新为 PRO
• 将用户的使用次数计数器重置为 0
• 用户接下来的 Agent 请求将顺畅通过

---

架构

                         +-----------------+
  Claude / Cursor        |  Cloudflare     |       +------------+
  (MCP Client)  -------->|  Worker (Hono)  |------>|  Supabase  |
                POST     |                 |       |  (users)   |
                /mcp     |  Revenue Gate   |       +------------+
                         |  MCP Server     |
                         |  Stripe Webhook |------>  Stripe API
                         +-----------------+

• 运行时： Cloudflare Workers（边缘运行，冷启动约 0 毫秒）
• 框架： Hono（轻量级，原生支持 Workers）
• MCP SDK： 使用 Streamable HTTP 传输的 @modelcontextprotocol/sdk
• 身份验证： 在 x-api-key 或 Authorization: Bearer 标头中提供 API 密钥
• 数据库： Supabase（PostgreSQL）
• 支付： Stripe Checkout + Webhooks

---

自托管

git clone https://github.com/maryadawson-code/integritypulse.git
cd integritypulse
npm install

# Configure secrets
cp .env.example .env
# Edit .env with your Supabase and Stripe credentials

# Local development
npx wrangler dev

# Deploy to Cloudflare Workers
npx wrangler secret put SUPABASE_URL
npx wrangler secret put SUPABASE_SERVICE_KEY
npx wrangler secret put STRIPE_SECRET_KEY
npx wrangler secret put STRIPE_WEBHOOK_SECRET
npx wrangler deploy

---

License

MIT