norc

norc-mcp

用于将 AI 平台（Claude、ChatGPT 等）连接到你的 norc 账户的 MCP 服务，可在聊天中管理 cron 作业、机器和运行历史记录。

设置

1. 生成 norc API 密钥：vault → Settings → API Keys → Generate key。
2. 为客户端安装（见下文）。托管选项：将支持远程服务的客户端指向 https://mcp.norc.app/mcp，并将你的密钥用作 Bearer 令牌（具体字段取决于客户端）。

安装

Claude Desktop

1. 安装 20 或更高版本的 Node.js（Claude Desktop 使用 npx 运行服务）。
2. 打开 Claude Desktop → Settings → Developer → Edit Config。这会打开 claude_desktop_config.json：
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json（Microsoft Store 安装：%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json）
3. 在 mcpServers 下添加 norc（保留已有的服务），并使用你自己的密钥（vault → Settings → API Keys）：

   {
     "mcpServers": {
       "norc": {
         "command": "npx",
         "args": ["-y", "norc-mcp"],
         "env": { "NORC_API_KEY": "norc_sk_..." }
       }
     }
   }
   

   在 Windows 上，npx 是 .cmd 脚本，可能无法直接启动；请改用 cmd：

   "command": "cmd",
   "args": ["/c", "npx", "-y", "norc-mcp"]
   

4. 完全退出 Claude Desktop 后重新打开。仅关闭窗口并不足够。之后，norc 的工具会显示在工具菜单中。

Claude Code

安装 norc 插件，它会添加斜杠命令并为你启动此服务；也可以直接添加：

claude mcp add norc --env NORC_API_KEY=norc_sk_... -- npx -y norc-mcp

其他本地 MCP 客户端（Cursor 等）

使用与上方 Claude Desktop 配置相同的 command / args / env 块。如果没有 NORC_API_KEY（或 --stdio），服务会改为以 HTTP 模式启动；在 stdio 模式下，如果密钥缺失或格式错误，程序会报错退出。

托管（远程客户端）

对于仅支持远程服务的客户端，请使用 https://mcp.norc.app/mcp（Streamable HTTP，POST），并设置请求头 Authorization: Bearer norc_sk_...。这里运行的代码与此仓库相同，部署在 Vercel 上；你的密钥会转发到 vault.norc.app，不会被存储。

工具

• list_jobs、create_job、update_job、delete_job
• list_machines、rename_machine、delete_machine
• list_runs
• sync_jobs — 声明式同步完整的作业集（类似 norc gitops）。默认执行试运行；当 apply 为 true 时，不在列表中的作业会被删除。需要在你的账户上启用 gitops sync 功能。

自托管（HTTP）

此服务是一个轻量、无状态的客户端——不持有任何机密信息，也不访问自己的数据库。它只会将你的 API 密钥转发到 vault.norc.app（或 $NORC_VAULT_URL）。如有需要，你可以运行自己的实例：

pnpm install
pnpm build
PORT=3000 node dist/server.js

注意：自托管此服务并不意味着自托管 norc 本身——它仍会调用托管的 norc API。

通过 Docker 运行

docker run -p 3000:3000 norcapp/norc-mcp

如果要指向非默认的 vault 实例，请设置 NORC_VAULT_URL：

docker run -p 3000:3000 -e NORC_VAULT_URL=https://vault.norc.app norcapp/norc-mcp

许可证

MIT