Nora

本地服务

noradocs.solomontsao.comAI 与智能体592 周前更新

代码仓库访问官网

关于 Nora

Nora 的 MCP 服务，用于通过 MCP 客户端管理自托管的 OpenClaw 和 Hermes Agent 集群，支持 Docker 与 Kubernetes。它面向需要以自然语言运维 Agent 运行时的团队。

主要功能

01部署、启动、停止、重启与重新部署 Agent
02查询集群状态、指标、事件和单个 Agent 成本
03按 API 密钥作用域区分读写工具
04delete_agent 需显式开启才可使用
05以无状态的本地进程运行，不保存凭据

适用场景

01在 Claude Code 或 Cursor 中查看 Agent 集群健康状况
02通过自然语言部署或重启 Agent 运行时
03查看各 Agent 的指标与成本

MCP 相关

该服务是 Nora 控制平面的 MCP 服务，向 Claude Code、Claude Desktop、Cursor 等 MCP 客户端暴露 Agent 生命周期、监控和指标相关的工具，工具输出为 Nora REST 接口的原始 JSON。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "solomon2773-nora": {
      "command": "npx",
      "args": [
        "-y",
        "@noraai/mcp-server"
      ],
      "env": {
        "NORA_API_URL": "<NORA_API_URL>",
        "NORA_API_KEY": "<NORA_API_KEY>",
        "NORA_MCP_ALLOW_DESTRUCTIVE": "<NORA_MCP_ALLOW_DESTRUCTIVE>"
      }
    }
  }
}

启动命令npx -y @noraai/mcp-server

需要配置的环境变量

NORA_API_URLBase URL of your Nora backend API (e.g. https://nora.example.com). Falls back to NORA_HOST, then the Nora CLI config at ~/.nora/config.json.

NORA_API_KEY密钥Nora workspace API key (nora_…) used to authenticate against the Nora public REST API. Falls back to NORA_TOKEN, then the Nora CLI config.

NORA_MCP_ALLOW_DESTRUCTIVESet to "true" to enable destructive tools (e.g. delete_agent). Disabled by default.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@noraai/mcp-server0.1.4stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
scope	enum	否	'owned' 表示仅限由该密钥签发用户创建的 Agentaccessible \| owned

详细介绍

@noraai/mcp-server

适用于 Nora 的 MCP 服务。Nora 是一个可自托管的 AI Agent 运维平台。将 Claude Code、Claude Desktop、Cursor 或任何 Model Context Protocol 客户端连接到 Nora 控制平面，即可使用自然语言管理 Agent 集群：部署运行时、启动／停止／重启运行时、查看集群状态，并获取指标、事件和各 Agent 的成本。

claude mcp add nora \
  --env NORA_API_URL=https://nora.example.com \
  --env NORA_API_KEY=nora_xxxxxxxx \
  -- npx -y @noraai/mcp-server

仓库还在 claude-plugin/ 下附带了 Claude Code 插件清单。可在 Nora 检出目录中验证并加载：

claude plugin validate ./mcp-server/claude-plugin --strict
claude --plugin-dir ./mcp-server/claude-plugin

也可以在任何 MCP 客户端的 JSON 配置中使用：

{
  "mcpServers": {
    "nora": {
      "command": "npx",
      "args": ["-y", "@noraai/mcp-server"],
      "env": {
        "NORA_API_URL": "https://nora.example.com",
        "NORA_API_KEY": "nora_xxxxxxxx"
      }
    }
  }
}

Docker

将同一 stdio 服务构建为非 root 容器：

docker build -t nora-mcp ./mcp-server
docker run --rm -i \
  -e NORA_API_URL=https://nora.example.com \
  -e NORA_API_KEY=nora_xxxxxxxx \
  nora-mcp

MCP 客户端应保持 stdin 打开，并通过环境变量传递密钥；镜像不会持久化凭据或其他状态。

身份验证

使用 Nora 工作区 API 密钥（在 Workspace → API Keys 下创建）。权限范围保持不变：

agents:read + monitoring:read → 读取工具
agents:write → 部署／生命周期工具

后备方式：先使用 NORA_HOST／NORA_TOKEN 环境变量，再使用 Nora CLI 的 ~/.nora/config.json——因此，执行 nora login 后，nora mcp（或直接运行 npx @noraai/mcp-server）即可使用。

工具

读取：list_agents、get_agent、get_agent_stats、get_agent_versions、get_platform_metrics、get_fleet_status、list_monitoring_events、get_agent_metrics、get_agent_metrics_summary、get_agent_cost。

写入：deploy_agent、start_agent、stop_agent、restart_agent、redeploy_agent——以及 delete_agent，仅当 NORA_MCP_ALLOW_DESTRUCTIVE=true 时才会注册。

工具输出为原始 Nora REST JSON；此服务是纯 API 客户端，不存储任何内容。

完整指南：docs.norafleet.ai/guides/mcp-server

隐私政策

Nora MCP 连接器在本地运行，不会收集遥测数据，也不会持久化凭据、工具输入或 API 响应。它会将每个工具请求和配置的 API 密钥直接发送到由 NORA_API_URL 指定的 Nora 部署；不会有独立的连接器服务或广告网络接收这些数据。

连接器进程退出后不会保留任何数据。你的 Nora 操作员负责管理该部署中的账户、Agent、日志、指标和集成数据的存储与保留；Nora 调用的已连接提供方也可能采用各自的政策。请参阅完整的 Nora 隐私政策，或联系 [email protected]。

参与贡献

在仓库根目录中，先运行一次 npm run contributor:setup -- --scope mcp-server，然后运行 npm run contributor:check -- mcp-server。请确保工具架构、安全注释、README 工具列表和模拟传输测试与公开 REST 端点保持同步。

如果 Nora 对你有用，请在 GitHub 仓库点个 ⭐，帮助其他自托管用户找到它。