Sunra.ai Mcp Server

Sunra MCP サーバー

英語 | 簡体字中国語

Sunra.ai サービスとやり取りするためのツールを提供する、Model Context Protocol（MCP）サーバーです。

インストール

npm から（推奨）

npx @sunra/mcp-server --help

ローカル開発

git clone https://github.com/sunra-ai/sunra-clients.git
cd sunra-clients/mcp-server
npm install
npm run build

使用方法

コマンドラインオプション

sunra-mcp-server [options]

Options:
  -t, --transport <type>   Transport type: 'stdio' or 'http' (default: stdio)
  -p, --port <number>      Port for HTTP transport (default: 3000)
  -h, --host <string>      Host for HTTP transport (default: localhost)
  --help                   Show this help message

Examples:
  sunra-mcp-server                           # Start with stdio transport
  sunra-mcp-server --transport http          # Start with HTTP transport on port 3000
  sunra-mcp-server -t http -p 8080           # Start with HTTP transport on port 8080

Cursor IDE の場合

以下を .cursor/mcp.json ファイルに追加します。

{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "env": {
        "SUNRA_KEY": "${SUNRA_KEY}"
      }
    }
  }
}

Claude Desktop の場合

以下を Claude Desktop の設定ファイルに追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "env": {
        "SUNRA_KEY": "${SUNRA_KEY}"
      }
    }
  }
}

機能

• 基本ツール：送信、ステータス確認、結果取得、キャンセル、サブスクライブ操作
• モデル管理：AI モデルの一覧表示、検索、スキーマ情報の取得
• ファイル管理：Sunra.ai へのファイルのアップロード
• 認証：API キーの安全な管理
• 複数のトランスポート：stdio（Claude Desktop 用）と HTTP（Cursor 用）の両方をサポート

ツール

基本操作

• submit - モデルのエンドポイントにリクエストを送信します
• status - リクエストのステータスを確認します
• result - 完了したリクエストの結果を取得します
• cancel - 保留中のリクエストをキャンセルします
• subscribe - リクエストを送信し、完了まで待機します

モデル管理

• list-models - 利用可能なすべてのモデルを一覧表示します
• search-models - 名前または説明でモデルを検索します
• model-schema - 特定のモデルエンドポイントの入力スキーマと出力スキーマを取得します

ファイル管理

• upload - ファイルを Sunra.ai のストレージにアップロードします

認証

• set-sunra-key - Sunra.ai API キーを設定します

使用例

モデルスキーマツール

model-schema ツールは、owner/model/endpoint 形式のモデルスラッグを受け取り、入力スキーマと出力スキーマのみを返すようになりました。

# Get schema for a specific model endpoint
model-schema --modelSlug "black-forest-labs/flux-kontext-max/text-to-image"

参照の解決

このツールは OpenAPI の $ref 参照を自動的に解決し、完全に展開されたスキーマを提供します。たとえば、元の OpenAPI スキーマに次の内容が含まれている場合：

{
  "schema": {
    "$ref": "#/components/schemas/TextToVideoInput"
  }
}

このツールはこの参照を解決し、実際のスキーマ定義を返します。

{
  "inputSchema": {
    "type": "object",
    "properties": {
      "prompt": {
        "type": "string",
        "description": "Text prompt for video generation"
      },
      "duration": {
        "type": "integer",
        "enum": [5, 10],
        "description": "Duration of the video in seconds"
      }
    },
    "required": ["prompt"]
  }
}

このツールは次のケースに対応します：

• ✅ 単純な参照（#/components/schemas/SchemaName）
• ✅ オブジェクトや配列内のネストされた参照
• ✅ 循環参照（$circular: true としてマーク）
• ✅ 見つからない参照（元の $ref にフォールバック）

レスポンス形式

レスポンス形式：

{
  "success": true,
  "modelSlug": "black-forest-labs/flux-kontext-max/text-to-image",
  "owner": "black-forest-labs",
  "model": "flux-kontext-max",
  "endpoint": "text-to-image",
  "inputSchema": {
    "type": "object",
    "properties": {
      "prompt": {
        "type": "string",
        "description": "Text prompt for image generation"
      }
    },
    "required": ["prompt"]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "description": "Request ID"
      },
      "status": {
        "type": "string",
        "description": "Request status"
      },
      "output": {
        "type": "object",
        "description": "Generated output"
      }
    }
  }
}

開発

テストの実行

npm test

ビルド

npm run build

サーバーの起動

npm start

設定

Sunra.ai API キーを環境変数として設定します。

export SUNRA_KEY="your-api-key-here"

または、実行時に set-sunra-key ツールを使用します。

公開

npm に公開するには：

npm run build
npm publish

API リファレンス

詳しい API ドキュメントについては、Sunra.ai API ドキュメントをご覧ください。