Finops Calculator MCP

MCP工作区

官方产品名称： 虚构的卡尔.

前描述性名称：FinOps和云经济计算器。

此文件夹专用于FiceCal的所有模型上下文协议（MCP）相关工作。

发布3捆绑包（今天）

MCP的版本3侧重于与FiceCal计算器的UI感知状态奇偶校验和第一定时器流兼容性：

• 确定性经济扫描(scanEconomicRange)用于盈亏平衡和最低单位成本检测
• 统一成本助手(totalCostAtClients)在定价和健康计算中重复使用
• 盈亏平衡和推荐上下文与整数范围经济扫描对齐（不是采样图表点）
• 零基础设施CCER处理与 Infinity 只有有限罚分的语义
• 零价值成本输入路径(devPerClient=0, infraTotal=0)模型推导中的一致归一化
• 共享状态负载现在包括规范化的UI上下文(ui 意图+ um 模式）用于MCP编码令牌
• finops.calculate 现在接受可选 uiIntent / uiMode 因此生成的状态令牌在相同的角色/模式上下文中打开
• finops.state.encode 模式现在支持显式UI上下文参数
• 交叉回购奇偶校验保护现在生效 SHARE_STATE_VERSION, UI_MODE_OPTIONS，以及 UI_INTENT_OPTIONS 漂移
• 根据计算器源验证交叉回购奇偶校验测试(npm run test:parity)
• 包版本升级到 0.3.0

______________________________________________________________________

当前内容

• spec.md -MCP工具合同草案和推出范围
• schemas/finops.calculate.request.schema.json -主计算器MCP工具的请求模式
• schemas/finops.calculate.response.schema.json -主计算器MCP工具的响应模式
• examples/calculate.request.json -样本请求有效载荷
• examples/calculate.response.json -样本响应有效载荷
• client-config-examples.md -复制粘贴MCP客户端配置片段（Cursor、Windsurf、Claude Desktop）
• server/finops-core.js -为MCP处理程序提取纯计算器逻辑
• server/index.js -带工具注册和JSON-RPC处理的MCP stdio服务器
• server/package.json -本地运行/检查/测试脚本
• docs/agents/private-adk-a2a-render-spec.md -Render上代理中心（ADK+A2A路径）的私有实现规范
• server/agents/api-server.js -渲染就绪的HTTP代理中心骨架(/healthz, /v1/agent/triage)
• server/agents/contracts/* -精确的v1分诊请求/响应合同+工具合同指南
• server/agents/workflows/triage.workflow.v1.json -第一个映射到现有FinOps MCP逻辑的工作流定义
• server/agents/render/render.yaml -渲染蓝图配置（自由层配置文件）
• server/agents/render/smoke-triage.sh -局部/CI烟雾测试 /healthz 和 /v1/agent/triage
• tests/run-tests.mjs -合约和JSON-RPC协议测试
• tests/validate-agent-artifacts.mjs -验证代理模式+工作流链接完整性
• tests/parity-finops-calculator.mjs -交叉回购平价防范 duksh/finops-calculator 主要的 index.html
• .github/workflows/mcp-parity.yml -CI管道运行语法、测试和奇偶校验保护

在本地运行MCP服务器

node /absolute/path/to/finops-calculator-mcp/server/index.js

或者从服务器文件夹：

npm run start

语法检查：

npm run check

测试套件：

npm run test

交叉回购奇偶校验保护（MCP\网络计算器）：

npm run test:parity

奇偶校验的可选覆盖目标：

FINOPS_CALCULATOR_RAW_URL="https://raw.githubusercontent.com/duksh/finops-calculator/main/index.html" npm run test:parity

客户端集成示例：

See client-config-examples.md

下一个实施步骤

1. 为回归覆盖率添加基于场景的黄金夹具。
2. 在服务器请求处理中添加可选的架构运行时验证。
3. 电线 server/agents 进入CI（语法+合约验证+烟雾端点测试）。
4. 在相同的v1分类合约后面添加ADK运行时适配器。
5. 添加A2A能力卡+任务端点(/v1/a2a/*)当需要跨代理集成时。

许可证

阿帕奇-2.0。看 LICENSE.