OperatorNest tools

OperatorNest 工具

托管的 MCP 端点：**https://operatornest.com/mcp**（Streamable HTTP，无需 API 密钥）。

五种确定性的成本、时区和日程安排计算使用捆绑数据，并通过 HTTP 和 stdio 使用相同的工具定义，返回规范化的输入、单位、方法、假设、注明日期的来源，以及在 OperatorNest 上打开每项结果的链接。不会进行网络调用。项目包含 TypeScript 源代码；计算不会创建事件、安装日程或执行任务。

工具	结果
ai_api_cost	根据令牌数量和所选模型费率，计算每次请求、每天和每月的美元成本
meeting_time_zones	为 2–8 人提供 09:00–17:00 之间共同的 30 分钟时段
recurring_schedule	每月小时数、重复规则和 RFC 5545 日历
ai_subscription_stack_cost	每月和每年的总计，以及重叠的功能
cron_next_runs	在某个 UTC 时刻之后、366 天内的 1–10 个匹配项

justfile 会安装锁定的依赖项、检查先决条件并运行构建和测试：

just setup
just doctor
just check

自托管

在检出代码进行开发时，运行 just setup 以安装 Node 26 和 pnpm 12。已发布的包支持 Node.js 22.19 或更高版本。

git clone https://github.com/OperatorNest/mcp-tools.git
cd mcp-tools
pnpm install --frozen-lockfile
pnpm test:local
pnpm build
node dist/stdio.js

对于支持 stdio 的客户端，将 node 与 dist/stdio.js 的绝对路径作为参数，以通过 stdin/stdout 提供以换行符分隔的 MCP 消息，同时将协议流量与写入 stderr 的日志分开。

该软件包已准备为 @operatornest/mcp-tools 版本 1.1.0。要在发布到注册表之前通过 npx 运行本地软件包：

pnpm pack --out /tmp/operatornest-mcp-tools-1.1.0.tgz
npx --yes --package /tmp/operatornest-mcp-tools-1.1.0.tgz operatornest-mcp-tools

发布到 npm 后，对应的命令为 npx --yes @operatornest/[email protected]。发布是维护者单独执行的操作。

HTTP Worker

src/worker.ts 导出一个带有 /mcp 端点的独立 Worker。使用你自己的 Worker 配置；wrangler.jsonc 是本地起始配置。使用以下命令在本地运行：

pnpm dev:worker --port 8787

将客户端连接到 http://localhost:8787/mcp。要托管到远程服务，请在你自己的账户中遵循 Worker 设置文档。

HTTP 处理程序使用无会话或订阅流的无状态 JSON 响应，将请求正文限制为 32 KiB，拒绝 JSON-RPC 批量请求并返回通用错误，同时支持 HTTPS 源的 CORS，以及本地端点的本地来源访问。

速率限制为可选项。要启用它，请配置 MCP_LIMITER 速率限制绑定。配置后，它会使用 CF-Connecting-IP 的 SHA-256 哈希；拒绝请求时会返回 HTTP 429 和 Retry-After: 60。缺少客户端 IP 或绑定出错时会返回 HTTP 503。未配置绑定则不进行速率限制。

客户端设置

以下代码片段连接到托管端点。若要使用你自己的 HTTP 实例，请替换为你自己的 HTTPS /mcp URL。设置文档核对日期为 2026 年 10 月 2 日；账户和工作区控件可能会影响工具访问权限。

ChatGPT

在“设置”→“安全与登录”中启用开发者模式。在“插件”中，使用加号按钮创建开发者模式应用，并填写此 URL，身份验证方式选择“无身份验证”：

https://operatornest.com/mcp

在对话的加号菜单中，从开发者模式选择该应用。官方说明。

Claude

在 Claude 中，打开“自定义”→“连接器”，选择“添加自定义连接器”，然后输入 https://operatornest.com/mcp。选择“无需登录”并添加连接器。在对话的加号菜单的“连接器”列表中启用它。组织所有者可能需要先添加该连接器。官方连接器说明。

对于 Claude Code：

claude mcp add --transport http operatornest https://operatornest.com/mcp

使用 /mcp 检查连接。官方说明。

Codex

codex mcp add operatornest --url https://operatornest.com/mcp

或者，在 ~/.codex/config.toml 中：

[mcp_servers.operatornest]
url = "https://operatornest.com/mcp"

官方说明。

Cursor

在项目中的 .cursor/mcp.json，或适用于所有项目的 ~/.cursor/mcp.json 中添加：

{
  "mcpServers": {
    "operatornest": { "url": "https://operatornest.com/mcp" }
  }
}

官方说明。

Gemini CLI

在 ~/.gemini/settings.json 中添加：

{
  "mcpServers": {
    "operatornest": { "httpUrl": "https://operatornest.com/mcp" }
  }
}

官方说明。

VS Code

在项目中添加 .vscode/mcp.json：

{
  "servers": {
    "operatornest": { "type": "http", "url": "https://operatornest.com/mcp" }
  }
}

从配置文件启动服务，并在 Agent 模式下启用其工具。官方说明。

数据与限制

API 费率冻结于 2026-09-28T17:08:16.340Z，存储在 src/data/pricing-snapshot.json 中，其中包含来自 models.dev 的 194 个模型。这是托管 MCP 的筛选快照。请使用随附的 modelId 值；更广泛的网站目录可能包含此服务不接受的记录。费率为空的条目不会列出。缺少缓存费率时，会回退到输入费率；批量折扣要求有已发布的数据。不包括非 token 费用。

订阅计划位于 src/data/ai-plans.ts，于 2026 年 9 月 27 日依据官方来源链接核验。年度总费用采用已公布的年费；若未列出年费，则按 12 个月费用计算。不包括税费、地区差异和促销优惠。

会议和 cron 结果使用运行时的 IANA 时区数据库。循环日历在导入的日历中使用浮动本地时间。Cron 支持 GitHub、Cloudflare、Quartz 和 AWS 方言中的数字星号、列表、范围、步长和星期名称；不支持 L、W、# 和月份名称。结果仅为估算和日程预览。

开发

pnpm check
pnpm test:local
pnpm build
pnpm dlx @modelcontextprotocol/inspector --cli node dist/stdio.js \
  --method tools/call --tool-name cron_next_runs \
  --tool-arg 'expression=0 9 * * 1-5' --tool-arg dialect=github \
  --tool-arg zone=UTC --tool-arg after=2026-10-02T00:00:00Z --tool-arg count=1

测试会验证输入和输出架构、有效和无效调用、HTTP 限制，以及两种传输方式上的初始化、列表和调用。请参阅 Inspector CLI 文档、贡献指南、安全问题报告和数据归属说明。

MIT。版权所有 (c) 2026 OperatorNest。