Costory FinOps MCP

Costory FinOps MCP：团队构建 FinOps Agent 的基础，可在 Claude、Cursor 或任何 MCP 客户端中使用

Costory 是团队构建 FinOps Agent 的基础。Claude 配合单个服务商的 MCP，适合一个人使用一个云平台；但当你接入更多服务商、用户和工具时，就难以为继。

• 多个服务商： 在统一模型中，将 AWS、GCP、Azure、LLM API 和数据云标准化并分配给团队和功能，还能根据遥测数据（Kubernetes、Datadog、dbt）进行分摊。
• 多个用户： 采用一套托管式配置，支持 OAuth、按用户授权和企业 SSO，无需为每个人单独配置本地凭据和提示词。
• 由 Costory 为你维护： Costory 会持续更新工具、技能和连接器，让组织调整和新服务不会导致 Agent 无法使用。

你的 Agent 可以发现节省成本的机会、解释每一笔支出变动，并提出编码 Agent 可实施的建议。它支持 Claude、Cursor 和任何 MCP 客户端，也支持 Slack。客户包括 Alan、Deezer、Delivery Hero、Voodoo 和 Pennylane。

定价： Starter 套餐每月 300 美元起，价格固定：用户和数据源数量不限，并提供 80% 的客户都用不满的合理使用额度。服务绝不会被切断，通过 MCP 连接的 Agent 不消耗 AI 额度。免费试用 30 天。

本仓库提供开源部分：Agent 技能和插件打包配置（Claude Code、Codex、Cursor），用于指导 Agent 基于 Costory MCP 工具运行 FinOps 工作流。

• 端点： https://app-api.costory.io/mcp（可流式传输的 HTTP）
• 身份验证： 在浏览器中使用 OAuth 2.1。无需 IAM 凭据、Docker 或本地服务
• 文档： docs.costory.io/features/mcp
• 注册名称： 官方 MCP Registry 上的 io.costory/finops

工程师会问它什么

• “为什么我们上周的 AWS 账单突然增加了？哪些部署时间与之吻合？”
• “按命名空间和团队拆分 payments 集群的 Kubernetes 成本。”
• “本月 OpenAI、Anthropic 和 Bedrock 的 AI 总支出是多少？按团队和模型分别统计。”
• “按使用量将共享 Cloud SQL 成本分摊给各团队，并将其发布为一个维度。”
• “本月与上月相比，我们的每位活跃用户对应的云成本是多少？”
• “如果 BigQuery 每日成本超过 2,000 美元，就创建提醒并发布到我们的 #finops Slack 频道。”
• “每周一将成本变动最大的前 5 项发送到 Slack。”

连接 MCP

单击即可将 https://app-api.costory.io/mcp 添加到 VS Code 或 Cursor；首次使用时，浏览器会打开 OAuth 登录页面。 如果想手动粘贴，可使用 Cursor 深层链接：cursor://anysphere.cursor-deeplink/mcp/install?name=costory&config=eyJ1cmwiOiJodHRwczovL2FwcC1hcGkuY29zdG9yeS5pby9tY3AifQ%3D%3D

你需要一个已连接计费数据的 Costory 工作区。Starter 套餐每月 300 美元起，价格固定；可免费试用 30 天。

**Claude Desktop / Claude Code / Cursor / VS Code：**添加一个指向 https://app-api.costory.io/mcp 的自定义连接器，然后在打开的浏览器窗口中完成 OAuth 登录。各客户端的操作指南附有屏幕截图，请参阅 MCP 文档。

此仓库提供了一个可供复制的 .mcp.json：

{
  "mcpServers": {
    "costory": {
      "type": "http",
      "url": "https://app-api.costory.io/mcp",
      "oauth": { "callbackPort": 8080 }
    }
  }
}

Claude Desktop（开发者配置 claude_desktop_config.json），请参阅备用 JSON 配置：

{
  "mcpServers": {
    "costory": {
      "url": "https://app-api.costory.io/mcp"
    }
  }
}

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "costory": {
      "type": "http",
      "url": "https://app-api.costory.io/mcp"
    }
  }
}

首条提示词

试试“使用 Costory 显示我上个月的主要成本驱动因素”。Agent 会调用 get_context，然后调用 query。

**如果你的账户有权访问多个组织，**不带 slug 调用 get_context 会返回“多个组织”及 slug 列表。Agent 应调用 list_organizations（或读取该列表），询问要使用哪个组织，并将该 slug 传递给 get_context 和后续工具。你也可以一开始就指定组织：“使用 Costory 组织 acme，显示我上个月的主要成本驱动因素”。

MCP 工具参考

此服务提供五组工具。名称和载荷均有版本管理； API 参考是权威信息来源。

分组	工具	功能
导览	get_context、search、get、suggest_groupby、suggest_usage_metrics、suggest_actions	发现维度、仪表板、指标，以及拆分问题的合适方式
查询	query、list_metrics、list_virtual_dimensions	查询成本、用量、指标、公式和预算，并进行周期对比
分配	create_virtual_dimension_draft、update_virtual_dimension_draft、preview_virtual_dimension_draft、publish_virtual_dimension、virtual_dimension_overlap_matrix	使用有序 CEL 规则定义自定义成本轴，预览后发布
报告	create_report、update_report、preview_report_widget、run_report_now、create_dashboard、update_dashboard	定时发送 Slack、Teams 和电子邮件报告，以及根据聊天内容构建仪表板
告警和事件	create_alert、preview_alert、list_alerts、create_event、update_event	成本和预算告警，以及用于关联分析的事件注释

写入工具仅在你的 Costory 工作区内执行操作。查询范围遵循调用用户的工作区角色。

FinOps 技能

技能是工作流层：每个技能都编码了针对某类问题如何安排上述工具的使用顺序，这样助手就不必重新摸索。

MCP skillId	适用场景
bigquery	BigQuery 数据仓库注意事项（按需与 slots、物理与逻辑、标签），以及 [BigQuery] 仪表板模板
cost-change-investigation	通过贡献度、时间、用量、指标、事件、提醒和术语证据解释成本变化
query	调查成本、用量、指标、公式和预算。Explorer 仅支持期间环比；将“发生了什么变化”的问题交给 reports Explain
virtual-dimensions	使用有序的 CEL 规则创建、编辑、预览和发布自定义成本维度
dashboards	通过上下文优先的小组件继承和概览生成来创建或扩展仪表板
reports	定时发送 Slack、Teams 和电子邮件报告，并优先预览 DIGEST，以解释上个月的成本
recipes	根据预期结果匹配现成的跟踪方案，然后交由上述技能来构建

Recipes 目前涵盖 BigQuery 数据仓库路由、基于 GCP 支出的 CUD、预算与实际值仪表板、EC2 峰值提醒、生产与研发拆分、未标记覆盖情况、Marketplace 支出、提供商抵免额、命名空间成本、计算资源细分，以及期间变化解释。请参阅 plugins/costory/skills/recipes/。

Cursor Marketplace 打包

此仓库还提供了与 Claude Code Marketplace 并列的 Cursor 插件布局：

• .cursor-plugin/marketplace.json — 多插件 Marketplace 清单
• plugins/costory/.cursor-plugin/plugin.json — Cursor 插件清单
• plugins/costory/mcp.json — 位于 https://app-api.costory.io/mcp 的托管 MCP（客户端中的 OAuth）
• plugins/costory/assets/logo.png — 插件徽标

已列入 cursor.directory/plugins/costory。

作为插件安装（MCP 连接 + 技能）

该插件会连接 MCP 服务，并一步安装这些技能。

# Claude Code
claude plugin marketplace add costory-io/costory-finops-mcp-skills
claude plugin install costory@costory

# Codex
codex plugin marketplace add costory-io/costory-finops-mcp-skills
codex plugin add costory@costory

仅安装技能，适用于任何 Agent（skills.sh）： 将这七个技能安装到 Claude Code、Cursor、 Codex 和其他支持 Agent Skills 的 Agent 中。请单独连接 MCP（见上文）。

npx skills add costory-io/costory-finops-mcp-skills

Kiro： 此仓库提供了一个 Kiro power（MCP 连接 + FinOps 技能）。在 Kiro 中，打开 Powers 面板 → Add Custom Power → Import power from GitHub，并输入 https://github.com/costory-io/costory-finops-mcp-skills/tree/main/powers/costory。

目录结构

.mcp.json                              ← ready-to-copy MCP client config
skills.json                            ← MCP skillId -> SKILL.md path
.claude-plugin/marketplace.json
server.json                            ← official MCP Registry entry (io.costory/finops)
gemini-extension.json + GEMINI.md      ← Gemini CLI extension (MCP connection + context)
powers/costory/                        ← Kiro power (plugin.json + mcp.json + skills/costory-finops)
plugins/costory/
  .claude-plugin/plugin.json
  .mcp.json                            ← MCP server wired by the Claude Code / Codex plugin
  README.md
  LICENSE                              ← Apache-2.0 (copy of the root LICENSE)
  skills/
    bigquery/SKILL.md
    cost-change-investigation/SKILL.md
    query/SKILL.md
    virtual-dimensions/SKILL.md
    dashboards/SKILL.md
    reports/SKILL.md
    recipes/SKILL.md  + recipe library

通过 MCP 提供技能（get_skill）

skills.json 将每个 MCP skillId 映射到一个 SKILL.md 路径。配置 costory-app 时，请从此仓库（或固定版本的发布包）加载文件，移除可选的 YAML frontmatter，并返回 Markdown 正文。

{
  "skillId": "dashboards",
  "path": "plugins/costory/skills/dashboards/SKILL.md"
}

编写

有关目录结构规则、版本更新和验证，请参阅 AGENTS.md。添加技能时请使用 SKILL_TEMPLATE.md。

支持

[email protected] · 文档 · 隐私政策 · 服务条款

许可证

Apache-2.0，详见 LICENSE。