venice-mcp

v1.2.5

Published

a month ago

MCP server for Venice AI - chat, images, TTS, embeddings, and account management

Venice MCP Server

A Model Context Protocol (MCP) server for Venice AI. Gives AI assistants like Claude access to Venice's text generation, image creation, text-to-speech, embeddings, and account management APIs.

What It Does

This MCP server lets Claude (or any MCP-compatible assistant) use Venice AI's features directly:

Chat with Llama, DeepSeek, Qwen, and other open models
Generate images using Stable Diffusion, FLUX, and more
Create speech from text with natural-sounding voices
Generate embeddings for search and RAG applications
Manage API keys and monitor rate limits

Quick Start

1. Get a Venice API Key

2. Install

npm install -g venice-mcp

3. Configure Claude Desktop

Add to your config file:

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

{
  "mcpServers": {
    "venice": {
      "command": "npx",
      "args": ["-y", "venice-mcp"],
      "env": {
        "VENICE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Claude Desktop. You'll see Venice tools available in the 🔧 menu.

Available Tools

Generation

| Tool | Description | |------|-------------| | venice_chat | Chat with Venice AI language models | | venice_generate_image | Generate images from text descriptions | | venice_upscale_image | Upscale and enhance images | | venice_text_to_speech | Convert text to spoken audio | | venice_create_embeddings | Generate text embeddings |

Discovery

| Tool | Description | |------|-------------| | venice_list_models | List available models (text, image, code) | | venice_list_characters | List character personas |

Account Management

Requires an admin-level API key:

| Tool | Description | |------|-------------| | venice_list_api_keys | List all API keys | | venice_create_api_key | Create a new API key | | venice_retrieve_api_key | Get details for a key | | venice_delete_api_key | Delete an API key | | venice_get_rate_limits | View rate limits and usage | | venice_get_rate_limit_logs | View rate limit history |

Examples

Ask Claude to generate an image:

"Use Venice to create an image of a sunset over mountains"

Chat with a specific model:

"Ask Venice's DeepSeek model to explain quantum computing"

Check your usage:

"Show my Venice API rate limits"

Supported Models

Language Models: Llama 3.3 70B, DeepSeek R1, Qwen 3, Mistral, and more
Image Models: Stable Diffusion 3.5, FLUX, Fluently XL
Embeddings: BGE-M3 (1024 dimensions)
TTS: Kokoro with multiple voice options

Run venice_list_models to see all currently available models.

Requirements

Node.js 18+
Venice AI API key

Development

Setup

git clone https://github.com/georgeglarson/venice-mcp.git
cd venice-mcp
npm install
npm run build

Testing

npm test              # Run tests
npm run test:watch    # Watch mode
npm run test:coverage # Coverage report

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT - see LICENSE