MCP 服务器

Wiro MCP Server

Official MCP server for Wiro AI that provides access to hundreds of AI models for generation, editing, and analysis from any MCP-compatible assistant.

README

Wiro MCP Server

Official MCP server for Wiro AI — access all AI models on Wiro from Cursor, Claude, Windsurf, and any MCP-compatible AI assistant.

Official MCP Server · Self-Hosted MCP · Models · Dashboard · Docs

</div>

Quick Start

1. Get API Keys

2. Add to Your AI Assistant

Cursor — open MCP settings (Cmd+Shift+P → "Open MCP settings") and add:

{
  "mcpServers": {
    "wiro": {
      "command": "npx",
      "args": ["-y", "@wiro-ai/wiro-mcp"],
      "env": {
        "WIRO_API_KEY": "your-api-key",
        "WIRO_API_SECRET": "your-api-secret"
      }
    }
  }
}

Claude Code:

claude mcp add wiro -- npx -y @wiro-ai/wiro-mcp

Then set environment variables WIRO_API_KEY and WIRO_API_SECRET.

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "wiro": {
      "command": "npx",
      "args": ["-y", "@wiro-ai/wiro-mcp"],
      "env": {
        "WIRO_API_KEY": "your-api-key",
        "WIRO_API_SECRET": "your-api-secret"
      }
    }
  }
}

Windsurf — add to MCP settings:

{
  "mcpServers": {
    "wiro": {
      "command": "npx",
      "args": ["-y", "@wiro-ai/wiro-mcp"],
      "env": {
        "WIRO_API_KEY": "your-api-key",
        "WIRO_API_SECRET": "your-api-secret"
      }
    }
  }
}

3. Start Using

Ask your AI assistant:

"Generate a photorealistic image of a mountain lake at sunset"
"What video generation models are available on Wiro?"
"Show me the parameters for openai/sora-2"
"Create a 5-second video with Kling V3 — a drone shot over mountains"
"Check the status of my last task"

Authentication

Wiro supports two authentication types (chosen when creating a project):

Signature-Based (Recommended)

More secure. Requires both API key and API secret.

WIRO_API_KEY=your-api-key
WIRO_API_SECRET=your-api-secret

API Key Only

Simpler. Only requires the API key. Omit WIRO_API_SECRET from your config.

WIRO_API_KEY=your-api-key

Available Tools

Tool	Description
`search_models`	Search and browse AI models by keyword, category, or owner
`get_model_schema`	Get full parameter schema and pricing for any model
`recommend_model`	Describe what you want to build, get model recommendations by relevance
`explore`	Browse curated models organized by category — no parameters needed
`run_model`	Run any model — wait for result or get task token
`get_task`	Check task status, outputs, and cost
`get_task_price`	Get the cost of a completed task
`cancel_task`	Cancel a queued task
`kill_task`	Kill a running task
`upload_file`	Upload a file from URL for use as model input
`search_docs`	Search the Wiro documentation for guides and API references

Hosted MCP Server

Wiro also provides a hosted MCP server at https://mcp.wiro.ai/v1 that requires no local installation. See the MCP Server documentation for setup instructions.

Documentation

MCP Server (Hosted) — setup guides for Cursor, Claude Code, Claude Desktop, Windsurf
Self-Hosted MCP — run locally with npx, environment variables, library usage
Authentication — signature-based vs API Key Only
Run a Model — how the Run endpoint works
Tasks — task lifecycle, statuses, determining success
Concurrency Limits — concurrent task limits based on balance
Error Reference — error codes and handling

Using as a Library

This package exports its core components for use in custom MCP servers:

import { createMcpServer, WiroClient } from '@wiro-ai/wiro-mcp';

const client = new WiroClient('your-api-key', 'your-api-secret');
const server = createMcpServer(client);

Exports

Export	Description
`createMcpServer(client)`	Creates an McpServer with all 11 tools registered
`WiroClient`	API client with both auth types
`registerTools(server, client)`	Register tools on an existing McpServer

// Import specific components
import { WiroClient } from '@wiro-ai/wiro-mcp/client';
import { registerTools } from '@wiro-ai/wiro-mcp/tools';

Environment Variables

Variable	Required	Description
`WIRO_API_KEY`	Yes	Your Wiro project API key
`WIRO_API_SECRET`	No	Your Wiro project API secret (for signature auth)
`WIRO_API_BASE_URL`	No	Override API base URL (default: `https://api.wiro.ai/v1`)