vap-mcp 0.2.0

VAP MCP Server - Execution control layer for Claude Desktop and MCP clients

vap-mcp

VAP MCP Server - Media generation tools for Claude Desktop via Model Context Protocol.

Generate AI images, videos, and music directly in Claude Desktop conversations.

Quick Install

# Using uvx (recommended)
uvx vap-mcp

# Or using pipx
pipx install vap-mcp

# Or using pip
pip install vap-mcp

Claude Desktop Configuration

Add to your Claude Desktop config (~/.config/Claude/claude_desktop_config.json on Linux/Mac or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "vap": {
      "command": "uvx",
      "args": ["vap-mcp"],
      "env": {
        "VAP_API_KEY": "vap_your_api_key_here"
      }
    }
  }
}

Get your API key at vapagent.com

Available Tools

Image Generation

• generate_image: Generate AI images using Z-Image-Turbo (~$0.002 per image)

Video Generation (Veo 3.1)

• generate_video: Generate AI videos with optional audio
  • 4 seconds: $2.40 (with audio) / $1.20 (without)
  • 6 seconds: $3.60 (with audio) / $1.80 (without)
  • 8 seconds: $4.80 (with audio) / $2.40 (without)

Music Generation (Suno V5)

• generate_music: Generate AI music from text prompts
  • Describe mood, genre, instruments, tempo
  • 30-60 seconds: $0.50
  • 120 seconds: ~$0.70
  • 180 seconds: ~$0.90
  • 240 seconds: $1.10
  • Optional instrumental-only mode

Task Management

• get_task: Check task status and retrieve results
• list_tasks: List recent generation tasks

Utilities

• check_balance: Check your account balance
• estimate_cost: Estimate image generation cost
• estimate_video_cost: Estimate video generation cost
• estimate_music_cost: Estimate music generation cost

Usage Examples

Once configured, you can ask Claude:

"Generate an image of a sunset over mountains"

"Create a 4-second video of ocean waves"

"Generate a 60-second upbeat electronic track with synths"

"Create instrumental jazz music, smooth and relaxing, 2 minutes"

"Check my balance"

Environment Variables

Variable	Description	Default
VAP_API_KEY	Your VAP API key (required)	-
VAP_API_URL	MCP API endpoint	https://api.vapagent.com/mcp
VAP_API_BASE_URL	Base API URL	https://api.vapagent.com
VAP_DEBUG	Enable debug logging	false

Running Standalone

# Run the MCP server directly
vap-mcp

# With debug logging
VAP_DEBUG=1 vap-mcp

Links

• Documentation
• API Reference
• Get API Key
• GitHub

License

MIT License - see LICENSE for details.