内容
# nable
*FinOps MCP 服务器,适用于 Claude 和 Cursor,支持 AWS、Azure、GCP、Kubernetes 和 15+ SaaS 及 AI 提供商。*
**您的 AI 代理在花费前检查的成本大脑。** 在 Claude 或 Cursor 中询问您的整个云账单和 AI 账单的任何问题,获得基于您的实际费率的真实节省,并以您批准的拉取请求形式提供修复。适用于 AWS、Azure、GCP、Kubernetes 和 15+ SaaS 及 AI 提供商的单一工具。
[](https://pypi.org/project/finops-mcp/)
[](https://pepy.tech/projects/finops-mcp)
[](https://github.com/getnable/finopsmcp/actions/workflows/test.yml)
[](LICENSE)
nable 是运行在您的 AI 中的 FinOps。询问 Claude 或 Cursor 关于您的云、SaaS 和 AI 支出,它会用基于您实际费率的真实数字回答。它会找到真正值得采取的节省措施,以您批准的拉取请求形式提出每个修复,并在下一次账单中检查是否有效。当您的代理开始花费真实资金时,nable 是他们在采取行动前检查的成本大脑。
所有操作都在 **您的机器** 上运行,您的账单从未离开过它,因此无需信任即可读取源代码。您可以通过 SSO 登录或 CLI 配置文件连接 AWS 或 GCP,nable 存储的密钥为零:它只引用您现有的登录;只有您直接粘贴的密钥才会加密在您的 OS 密钥环中。默认情况下,它是只读的,绝不会擅自更改您的云。本地代理是开放且可审计的;为团队提供托管平台。
**[getnable.com](https://getnable.com)** · 文档、快速入门和托管平台

### 免费开始,在您的 Claude 会员资格上运行
`uvx nable` 并开始询问。nable 作为本地 MCP 服务器运行在 Claude Desktop、Claude Code 或 Cursor 中,因此 **您的现有 Claude Pro/Max 或 Cursor 会员资格就是模型**。无需 Anthropic API 密钥,也无需按 token 计费。工具调用计入您的正常聊天使用次数,与任何长对话相同,绝不会产生单独的账单。
成本查询、异常检测和权利调整发现 **永久免费**。代理团队(您的代理在采取行动前检查的预算守护者、修复拉取请求和学习循环)是专业版。
---
## 快速开始
需要 Python 3.11 或更新版本。下面的 `uvx` 命令为您获取匹配的 Python。如果您选择 `pip` 路径,请先使用 `python --version`(或 `python3 --version`)检查。旧版 Python 上,pip 报告 `No matching distribution found for finops-mcp`。
**步骤 1:安装并运行设置向导**
需要 `uv` 吗?它在 macOS 或大多数 Linux 上不可预安装:
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh # macOS / Linux
# 或:brew install uv
```
然后:
```bash
uvx nable
```
不需要 `uv` 也不想使用它?在 Python 3.11+ 上,`pip install -U finops-mcp && finops welcome` 也有效。
第一次运行时下载依赖项,因此请稍候片刻,然后欢迎界面出现。
向导会引导您连接提供商,并在最后自动配置 Claude Desktop。无需编辑配置文件,无需手动环境变量。
**使用 Cursor?** 一键安装(打开 Cursor 并添加 nable):
[`cursor://anysphere.cursor-deeplink/mcp/install?name=nable&config=eyJjb21tYW5kIjogInV2eCIsICJhcmdzIjogWyItLXB5dGhvbiIsICIzLjEyIiwgImZpbm9wcy1tY3AiXX0=`](cursor://anysphere.cursor-deeplink/mcp/install?name=nable&config=eyJjb21tYW5kIjogInV2eCIsICJhcmdzIjogWyItLXB5dGhvbiIsICIzLjEyIiwgImZpbm9wcy1tY3AiXX0=)
然后运行 `finops setup` 一次以连接云账户。
**在 Anaconda 上?** 使用 uvx(隔离,不会影响您的 Anaconda 环境):
```bash
brew install uv && uvx nable setup
```
**步骤 2:连接 AWS(通常只需一个按键)**
```bash
finops setup aws
```
向导检查您已经有的 AWS 凭证(SSO 登录、AWS CLI 配置文件或默认凭证),显示它找到的账户,并在您确认时连接它。如果您已经在此机器上使用 `aws`,则您不会输入任何按键。
```
Checking for AWS credentials on this machine...
✓ Found working credentials: profile 'default' -> account 1234
Connect this account? [Y/n]
```
只有当找不到有效的凭证时,它才会引导您创建只读访问密钥。您想将 IAM 策略交给您的平台团队吗?运行 `finops setup aws --iam-template`。
**步骤 3:重启 Claude Desktop 并询问**
```
What are my AWS costs this month?
```
一旦您看到实际的成本明细,您就已经开始使用了。同时适用于 Cursor、Windsurf 和 VS Code。
**免费。全功能本地产品,包括代理团队,目前免费。无需信用卡,无试用期计费。**
---
要添加更多提供商:
```bash
finops setup aws # 添加另一个 AWS 账户
finops setup azure # 添加 Azure
finops setup slack # 配置警报
finops setup license # 激活许可证密钥(企业版)
```
---
## 您能问什么
- "什么导致我们的 AWS 账单在上个月增加了 40%?"
- "哪个 Kubernetes 命名空间过度配置了?”
- “本周有任何异常的成本峰值吗?”
- “哪些 EC2 实例应该降级?”
- “比较我们的云支出 vs SaaS 支出”
- “为任何超过 200 美元/月的 EC2 浪费创建 Jira 工单”
- “哪个团队在 Datadog 上花费最多?”
- “我们的 AWS 账单下个月会是什么样子?”
- “显示我可以优化的 RDS 实例”
- “我们的节省计划有效折扣率是多少?”
## 本地优先且可审计
您的凭证使用 Fernet 进行加密,并存储在您的 OS 密钥环中(macOS 密钥链、Windows 凭证管理器或 Linux 上的 libsecret)。它们永远不会离开您的机器。成本数据缓存在本地 SQLite 数据库中,nable 没有后端,因此我们永远不会看到您的成本数据或凭证。有一个诚实的警告:当您在 AI 编辑器中提出问题时,nable 返回的数字会发送到您的编辑器的 AI 提供商进行回答,与任何提示一样,永远不会发送到 nable 服务器。如果您需要零 AI 暴露,请使用 CLI(`finops` 命令),它永远不会触及模型。团队通过 Slack 警报、Notion 发布和 CSV 导出共享发现结果。不需要共享数据库。
nable 默认情况下是只读的。除非您明确启用清理模式,否则它绝不会在未经您明确许可的情况下写入您的 AWS 账户。运行 `finops setup aws --iam-template` 以生成具有 nable 所需权限的最小特权 IAM 策略。
这一切都不是凭空声称。阅读源代码,检查 [OpenSSF Scorecard](https://scorecard.dev/viewer/?uri=github.com/getnable/finopsmcp),运行 `finops-doctor` 以查看 nable 到底触及了什么,并设置 `NABLE_NO_TELEMETRY=1`(或 `FINOPS_AIRGAP=1` 以禁止所有非提供商请求)如果您想将其锁定。
---
## 隐私政策
完整政策:**https://getnable.com/privacy**
nable 运行在本地,从设计上具有私密性:
- **数据收集。** 在本地模式下,nable 不在服务器上收集任何个人数据。您的云、SaaS 和 AI 计费数据从您自己的提供商 API 读取,仅在您的机器上缓存。
- **使用和存储。** 凭证使用 Fernet 进行加密,并存储在您的 OS 密钥环中;成本数据缓存在您机器上的本地 SQLite 数据库中。本地路径上没有 nable 后端。
- **第三方共享。** nable 不出售、出租或共享您的数据。您的计费数据和凭证永远不会发送到 nable 服务器。当您在 AI 编辑器中提出问题时,nable 返回的数字由您的编辑器的 AI 提供商回答(与任何提示相同),永远不会通过 nable 路由。可选的集成(Slack、Notion、Jira、GitHub、电子邮件)仅发送您直接定向到它们的特定发现。
- **遥测。** 匿名、可选择退出的产品遥测(无凭证,无成本数据)。使用 `NABLE_NO_TELEMETRY=1` 禁用,或使用 `FINOPS_AIRGAP=1` 禁止所有非提供商网络调用。
- **数据保留。** 本地数据保留在您的机器上,直到您删除它。卸载或清除本地存储以删除它。
- **联系方式。** chaaandannn@gmail.com.
可选的托管/托管层以单独的隐私条款在上述链接处运行;您的数据永远不会与另一个客户的数据合并。
---
## 手动 Claude Desktop 配置
如果 `finops setup` 未自动配置 Claude Desktop,请运行:
```bash
finops setup claude
```
或手动添加到 `claude_desktop_config.json`:
**使用 uvx(推荐):**
```json
{
"mcpServers": {
"nable": { "command": "uvx", "args": ["--python", "3.12", "finops-mcp"] }
}
}
```
**使用绝对路径:**
```json
{
"mcpServers": {
"nable": { "command": "/usr/local/bin/finops-mcp" }
}
}
```
使用 `which finops-mcp` 获取路径。
配置文件位置:
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
- **Linux**: `~/.config/Claude/claude_desktop_config.json`
> **为什么使用 uvx?** Claude Desktop 是一个 GUI 应用程序,不会继承您的 shell 的 PATH。uvx 通过在自己的隔离环境中运行 finops-mcp 来解决这个问题。它是具有托管 Python 安装的公司机器上最可靠的选项。
## 给您的代理成本控制
nable 不仅仅是您的代理读取的工具。它是您的代理在采取 **之前** 影响成本的更改时调用的预动作门控:它会估算更改的成本,将其与您的预算进行比较,并提供更便宜的路径。它绝不会自行应用任何操作。
仅提案,您提出,人工审批。
在您的代理系统(Claude Code、Cursor 或任何 MCP 客户端)中添加一行:
> 在应用任何基础设施更改(terraform apply、helm upgrade、创建或调整资源)或启动昂贵的作业之前,请先调用 `check_action_policy` 并提供操作和更改(terraform plan、helm diff 或 `monthly_delta_usd`)。中继判决、美元影响和更便宜的路径(如果有)。绝不应用 `block` 或 `escalate` 操作;将其呈交给人工。nable 是咨询性质的,仅提案。
这将任何代理变成具有成本意识的代理。网关返回 `allow` / `warn` / `block` / `escalate` 对您的策略、每月和年度美元影响、预算判决(带有其数据年龄标签)以及更改为计算时的现货替代品。一旦关闭(删除、终止、购买承诺)和超出预算的更改始终升级到人工。
---
## 连接器(17)
| 提供商 | 它提取的内容 |
|---|---|
| AWS | 成本资源管理器(免费层)· CUR via S3(专业版:逐项粒度,节省计划,预留) |
| Azure | 成本管理 API · Advisor 成本建议 · VM 权利调整(Azure Monitor)· 原生预算 · 预测 |
| GCP | Cloud Billing API + BigQuery 导出 |
| Datadog | 使用情况计量 API v2:实际美元金额 |
| Snowflake | ACCOUNT_USAGE.METERING_HISTORY |
| Langfuse | 每日指标 API:模型成本、token 使用量、跟踪量 |
| MongoDB Atlas | 发票 API |
| Twilio | 使用记录 API |
| Cloudflare | 计费 API |
| Vercel | 发票 API(企业版) |
| New Relic | 数据摄入 + 用户计数 |
| Stripe | 费用和计费活动 |
| Databricks | DBU 使用量和 SQL 仓库支出 |
| OpenAI | API 使用量和模型 token 支出 |
| Anthropic | Claude API 使用量和 token 支出 |
**Azure 角色。** Azure 工具跨越三个 RBAC 角色,授予每个订阅的服务主体。没有它们,影响的工具将返回空结果(运行 `finops doctor` 检查):
| 角色 | 解锁 |
|---|---|
| 成本管理读取器 | 成本查询、预算、预测、按维度成本 |
| 读取者 | Azure Advisor 建议 + VM 列表(权利调整) |
| 监控读取器 | VM CPU 指标(权利调整) |
```bash
# 每个订阅重复一次
az role assignment create --assignee <client-id> --role 'Cost Management Reader' --scope /subscriptions/<sub-id>
az role assignment create --assignee <client-id> --role Reader --scope /subscriptions/<sub-id>
az role assignment create --assignee <client-id> --role 'Monitoring Reader' --scope /subscriptions/<sub-id>
```
---
## nable 实际执行的操作
nable 不仅仅是将计费数据导入 Claude 的连接器。它对您的基础设施进行主动分析,并将发现结果作为 Claude 可以理解和采取行动的工具。
每个发现结果都按我们确定的置信度分类。**建议** 是 nable 测量的内容:精确的美元数字、安全的修复和检查节省是否实际落实到您的下一个账单。**调查** 是值得确认的信号:一个诚实的量级估计,从不假装精确,并提供确认步骤。nable 提出,您批准,它验证。它绝不会擅自更改您的基础设施。
**AWS 深度审计** 超出成本资源管理器范围。它提取每个正在运行的资源的 CloudWatch 指标,并标记账单中不会显示的浪费:应该替换为 gp3 的 gp2 卷(20% 更便宜,性能相同)、未附加的 EBS 卷、空闲 NAT 网关每月 32 美元的基础费用、RDS 备份保留设置过高、CloudWatch 日志组没有保留策略而不断增长,以及 Lambda 函数分配的内存是实际使用量的两倍。将其视为 Compute Optimizer 加之其底层。
**异常检测** 使用 z-score、CUSUM 漂移和按周季节性归一化。当出现峰值时,它会深入 Cost Explorer 按标签进行钻取,并告诉您哪个团队、环境或服务驱动了它。异常发现和 Slack/Teams 警报免费;自动创建工单是付费功能。
**权利调整** 结合 AWS Compute Optimizer 和 nable 自己的 CloudWatch 分析。它提供特定的推荐实例类型和估算节省,而不是仅列出未充分利用的资源。建议免费;创建工单是付费功能。
**承诺分析**(付费功能)根据您的实际使用情况模拟 Savings Plans 和 Reserved Instance 覆盖率。它显示当前的实际折扣率、覆盖率缺口以及购买额外承诺可以节省的费用。
---
## 开源
**本地代理** 是开源且免费的:MCP 服务器、每个连接器、成本查询、异常检测、权利调整、AI 和 LLM 支出跟踪以及补丁草案(您批准的 PR 和工单)。在您的机器上运行它、审计它、修改连接器。
**托管平台** 为团队提供托管平台:一个托管的、单租户的工作空间,具有任何人都可以使用的仪表盘、SSO 和角色、计划报告以及托管的 AI 代理。单租户设计,您永远不会将您的账单与他人混淆。
查看 [getnable.com/pricing](https://getnable.com/pricing) 获取当前计划:社区版免费,企业版自定义。
### 许可证
此存储库 **Apache-2.0** 完整:MCP 服务器和所有工具、每个连接器、FOCUS 标准化、异常检测、权利调整以及建议-仅限 PR 循环。成本到代码归属是单独的 nable 企业产品的单独部分。
托管企业层(Web 仪表盘、SSO、控制平面和管理 AI 计费)不在此存储库中。它存在于单独的私有存储库中,并作为上述托管平台提供。---
## 故障排除
```bash
finops-doctor # 检查凭证、DB、网络、审计日志
finops setup claude # 重新运行 Claude Desktop 配置仅限
```
| 症状 | 修复 |
|---|---|
| 工具未出现在 Claude | 切换到 uvx 配置或使用绝对路径 |
| `command not found: `pip install finops-mcp` 或使用 `uvx` |
| AWS 返回无数据 | 运行 `finops setup aws`。向导自动将凭证写入编辑器配置。 |
| `No matching distribution found for finops-mcp` | 您的 Python 版本低于 3.11。请在 3.11 上检查 `python --version`,然后安装 (`uvx nable` 或 `python3.11 -m pip install finops-mcp`)。 |
| `cryptography` 构建错误 / `maturin failed` | uv 尝试在 Python 3.10 上从源代码编译 cryptography,这没有预构建的轮。请使用 3.11:`uvx nable` 或强制使用 `uvx --python 3.12 nable`。 |
| Python 3.8 / 3.9 / 3.10 错误 | nable 需要 Python 3.11+:`python3.11 -m pip install finops-mcp` |
| 企业 SSL 错误 | `pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org finops-mcp` |
| 权限被拒绝 | 安装到用户:`pip install --user finops-mcp` 或使用 `uvx` |
| 在家工作正常,在公司不行 | 使用 `uvx`(公司 IT 通常会剥夺自定义 PATH 条目) |
---
## 文档
完整设置指南:[getnable.com/docs](https://getnable.com/docs)
---
<sub>mcp-name: io.github.getnable/finops-mcp</sub>
连接信息
猜你喜欢
暂无推荐服务器