English Français العربية

OpenRouter 工作台 Local

السجل الرسمي التسويق والمبيعات

Local OpenRouter cost analytics, reports, experiments and routing presets over MCP stdio.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @cyuanxv/openrouter-analytics-mcp
Claude Code 
claude mcp add openrouter-local -e 'OPENROUTER_MANAGEMENT_KEY=<your openrouter_management_key>' -e 'OPENROUTER_WORKBENCH_DATA_DIR=<OPENROUTER_WORKBENCH_DATA_DIR>' -- npx -y @cyuanxv/openrouter-analytics-mcp@0.6.0-alpha.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "openrouter-local": {
            "command": "npx",
            "args": [
                "-y",
                "@cyuanxv/openrouter-analytics-mcp@0.6.0-alpha.3"
            ],
            "env": {
                "OPENROUTER_MANAGEMENT_KEY": "<your openrouter_management_key>",
                "OPENROUTER_WORKBENCH_DATA_DIR": "<OPENROUTER_WORKBENCH_DATA_DIR>"
            }
        }
    }
}

متغيرات البيئة

  • OPENROUTER_MANAGEMENT_KEY إلزامي سري Your own OpenRouter Management Key; keep it in the MCP client secret environment.
  • OPENROUTER_WORKBENCH_DATA_DIR إلزامي Absolute dedicated private data directory for the local SQLite database.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. OpenRouter 工作台｜费用分析、异常检测与模型路由配置
  2. 界面预览
  3. 从费用问题，到模型决策
  4. 为什么用它？
  5. 第一次使用
  6. 可以直接问的问题
  7. 选择本地版还是 Sites 云端版
  8. 可以做什么
  9. 验证源码（不需要密钥）
  10. 发布方式：下载源码，自行部署
  11. 开源许可与历史材料
  12. 源码与安装包
  13. 版权与许可

OpenRouter 工作台｜费用分析、异常检测与模型路由配置

0.6.0-alpha.3 为本地版 alpha 版本；各渠道发布与验收状态见发布与验收记录。

简体中文 | English

看懂每一笔 AI 开销，让下一次模型选择更有把握。

OpenRouter 工作台（OpenRouter Workbench）是一个可自行部署的 OpenRouter 费用分析与 LLM 用量管理工具。把余额查询、模型与供应商费用拆解、异常检测、周报和模型路由方案集中到一个个人工作台，通过 MCP 在本地客户端中使用；部署 Sites 云端版后，也能在 ChatGPT 中查询。

不止看到账单数字：找到费用变化的线索，比较模型选择，保存可追溯的方案，把分析变成下一步行动。

由 cyuanxv 开发 · 在 X / Twitter 关注 @cyuanxv 第三方项目，非 OpenRouter 官方产品，未获官方背书。

界面预览

Sites 版当前源码真实界面，使用本地模拟数据；金额不是实际账单或模型报价。

从费用问题，到模型决策

flowchart LR
  A[自己的 OpenRouter 账户] --> B[费用与用量分析]
  B --> C[异常检测与原因线索]
  B --> D[保存周报与成本实验]
  C --> E[比较模型与供应商]
  E --> F[保存及导出路由方案]

功能流程示意，非界面截图；导出的方案需由你接入业务，工作台不会自动切换线上模型。

为什么用它？

  • 知道钱花在哪里：按模型、供应商和时间查看用量与费用，不再只盯着总金额。
  • 让异常开销有迹可循：检测费用变化并提供归因线索；数据不足会明确标注，不把未知当正常。
  • 把一次分析变成持续记录：保存周报、异常记录和成本实验，方便回看与比较。
  • 把模型选择变成可复用方案：保存主模型、备用模型与供应商偏好，管理版本并导出请求配置。
  • 让自己的数据留在自己的部署中：本地版保存到自己的 SQLite，Sites 版保存到自己的云端数据库；账户查询会访问 OpenRouter，工具返回结果受所用客户端的数据政策约束。

第一次使用

从 新用户快速上手 开始：配置 Key → 运行中文自检 → 查询账户 → 保存并查看第一份费用报告。遇到问题查看 常见问题。教程以本地 MCP 版为主，Sites 部署请按下方对应说明。

可以直接问的问题

  • “昨天 OpenRouter 花了多少钱？主要花在哪些模型上？”
  • “最近七天有没有费用异常？数据够不够支持这个结论？”
  • “生成上一周的费用报告并保存，不发送通知。”
  • “比较这几个模型，并帮我保存一个包含备用模型的方案。”

选择本地版还是 Sites 云端版

两种版本共享 28 个 MCP 工具，但运行方式与配套能力不同：

对比本地 MCP 版 · 0.6.0-alpha.3Sites 云端版 · 0.5.0
运行位置自己的电脑，需保持进程运行自己的 ChatGPT Sites 项目，不依赖本机持续开机
使用入口支持本地 stdio 的 MCP 客户端，例如 Cursor自己的私有网页和 ChatGPT 云端插件
数据保存本机专用目录中的 SQLite自己的 Sites D1 数据库
必要条件Node.js 22.22+（22 系列）或 24+、MCP 客户端；账户查询需自己的 Management KeySites 相应权限、身份认证、D1 和服务端秘密配置；账户查询需自己的 Management Key
网页界面不附带；上方截图展示的是 Sites 网页提供网页工作台
定时报告和 Telegram无内置调度或自动发送需另行配置云端任务与 Telegram 通知通道，不随源码自动启用
安装说明本地版安装Sites 云端部署

本地 stdio 进程不能直接作为 ChatGPT 云端连接入口。 想在电脑上的 MCP 客户端使用，选本地版；想用网页或 ChatGPT 云端连接，选 Sites 版。现有作者私人服务不供公共安装使用。

本地版安装：npm install --ignore-scripts @cyuanxv/openrouter-analytics-mcp@0.6.0-alpha.3。客户端配置见本地安装说明，也可使用 GitHub Release 安装包。另见功能与边界和安全说明。

本地版新增 安装与配置自检，提供中文诊断、离线与 JSON 模式。

本地版 0.6.0-alpha.3 新增易读费用报告：先看花费与增减，再看模型变化和数据缺口；已有报告保持原样。

可以做什么

查余额和费用、分析模型与供应商用量、查询调用元信息、检测及解释费用异常、保存周报与提醒记录、比较模型、记录成本实验、保存和导出模型路由方案。

报告与预设会写入部署者自己的数据库；上游账户查询不修改 OpenRouter 账户。不会执行付费模型推理、充值、修改 Key 或自动替业务切换模型。Telegram 定时发送由另行配置的云端任务完成。

验证源码（不需要密钥）

验证本地 MCP 版：

cd openrouter-analytics-mcp/packages/local-mcp
npm ci --ignore-scripts
npm run build
npm test

需使用完整源码树，构建会复用 services/routerlens。仅安装发行包无需构建，见本地版安装说明。

验证 Sites 服务源码：

cd openrouter-analytics-mcp/services/routerlens
npm ci --ignore-scripts
npm run build
npm test
npm run validate

此流程验证构建和模拟测试，不创建云服务、不调用真实账户。部署请先完整阅读安装说明。

发布方式：下载源码，自行部署

已确定采用个人自行部署方式。cyuanxv 提供开源代码和文档，不提供面向公众的托管账单服务；使用者负责自己的部署、OpenRouter 账户、密钥及托管费用。当前不提交 ChatGPT 审核。

开源许可与历史材料

代码采用 Apache-2.0，参见 LICENSE。品牌图标属于 OpenRouter，不纳入本项目代码许可证的授权范围，见 素材说明。

提供自部署源码和本地 MCP 安装包，暂不上架 ChatGPT。 根目录插件清单是需要使用者配置的模板，分析服务地址为无效占位符，不能原样连接。

源码与安装包

下载源码或克隆仓库到 openrouter-analytics-mcp 目录。本仓库以干净源码建立独立历史，不包含原私人仓库历史或私人部署配置。

GitHub 简介、Topics 与分享封面配置草稿

MCP Registry 发布条件与登记材料

本地可安装 MCP 版（0.6.0-alpha.3，完整 28 工具）

本地包安装与验收结果

本地包真实账户只读验收

Release preparation / 发布前清单 · 0.6.0-alpha.3 notes

Cursor desktop installation acceptance / 桌面安装验收

版权与许可

© 2026 cyuanxv · X / Twitter @cyuanxv

本项目采用 Apache-2.0 许可证。OpenRouter 名称及官方图标的权利归其各自权利人所有。

自动测试与验收范围：Linux Node 22/24 构建、模拟测试及安装包 stdio 检查；当前运行结果见 CI。

الأسئلة الشائعة

ما هو OpenRouter 工作台 Local؟

Local OpenRouter cost analytics, reports, experiments and routing presets over MCP stdio.

كيف أثبّت OpenRouter 工作台 Local؟

يعمل على جهازك. في Claude Code: claude mcp add openrouter-local -e 'OPENROUTER_MANAGEMENT_KEY=<your openrouter_management_key>' -e 'OPENROUTER_WORKBENCH_DATA_DIR=<OPENROUTER_WORKBENCH_DATA_DIR>' -- npx -y @cyuanxv/openrouter-analytics-mcp@0.6.0-alpha.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج OpenRouter 工作台 Local إلى مفتاح API؟

نعم. يتطلب OPENROUTER_MANAGEMENT_KEY, OPENROUTER_WORKBENCH_DATA_DIR، وتضبطها في إعداداته.

هل OpenRouter 工作台 Local مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون OpenRouter 工作台 Local؟

ينشره cyuanxv. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.