Skip to main content

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

Project description

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

License

MIT License - see LICENSE for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vap_mcp-0.2.1.tar.gz (8.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vap_mcp-0.2.1-py3-none-any.whl (8.8 kB view details)

Uploaded Python 3

File details

Details for the file vap_mcp-0.2.1.tar.gz.

File metadata

  • Download URL: vap_mcp-0.2.1.tar.gz
  • Upload date:
  • Size: 8.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for vap_mcp-0.2.1.tar.gz
Algorithm Hash digest
SHA256 b6c6c5b2fac1ca22103fc11dc76b5de0ba4402fb313cef04d2770ce28a2e24a7
MD5 a03013d3e1e34cfe3f598ae9f415b6e7
BLAKE2b-256 739d43892499ea85bf19643b83d86cdce9c00d64d5aae6c55c5668c50b38dbeb

See more details on using hashes here.

File details

Details for the file vap_mcp-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: vap_mcp-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 8.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for vap_mcp-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e17e4eab23da89248e87d4c50bac18b48c37df65d8a5eb18415f4ed5bc1f9e36
MD5 3213e3736a7b834d286623c5b7e11c68
BLAKE2b-256 498e53b8b0721038590d56328b6fa5382a757e4fdae494c5c4fde059b7d9611e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page