Nora

@noraai/mcp-server

セルフホスト可能な AI エージェント運用プラットフォームであるNora向けの MCP サーバーです。Claude Code、Claude Desktop、Cursor、または任意のModel Context Protocolクライアントを Nora のコントロールプレーンに接続し、自然言語でエージェント群を操作できます。ランタイムのデプロイ、起動・停止・再起動、エージェント群の状態確認、メトリクス、イベント、エージェントごとのコストの取得が可能です。

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

このリポジトリには、Claude Code プラグインのマニフェストも claude-plugin/に含まれています。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 オペレーターが制御します。また、Nora が連携プロバイダーを呼び出す際には、各プロバイダー独自のポリシーが適用される場合があります。詳しくはNora プライバシーポリシーをご覧いただくか、[email protected]までお問い合わせください。

コントリビューション

リポジトリのルートから、まず npm run contributor:setup -- --scope mcp-server を一度実行し、続けて npm run contributor:check -- mcp-server を実行してください。ツールのスキーマ、安全性に関するアノテーション、README のツール一覧、モックトランスポートのテストは、公開 REST エンドポイントと常に同期させてください。

Nora が役に立った場合は、GitHub リポジトリに ⭐ を付けていただくと、ほかのセルフホストユーザーにも見つけてもらいやすくなります。

ライセンス

Apache-2.0