跳转到主要内容
Venice MCP Server 是 Venice 的官方 Model Context Protocol 服务器。它将完整的 Venice API（聊天、图像、视频、音频、音乐、embeddings、web augment 和 character）作为 31 个工具暴露给任何兼容 MCP 的 agent。

GitHub: veniceai/venice-mcp-server

以 @veniceai/mcp-server 发布到 npm。MIT 许可。

31 个工具

一个配置块覆盖每种 Venice 模态

任何 MCP 宿主

Claude Desktop、Cursor、ChatGPT、LM Studio、Continue 等

钱包身份验证（可选）

带上 API 密钥，或通过 x402 用 SIWE 签名的钱包按次付费

​
快速入门

1

获取 Venice API 密钥

从 venice.ai/settings/api 生成。逐步说明请参阅 API 密钥指南。
2

将 Venice 添加到 MCP 宿主配置

将以下内容放入您的 MCP 宿主配置文件：
{
  "mcpServers": {
    "venice": {
      "command": "npx",
      "args": ["-y", "@veniceai/[email protected]"],
      "env": { "VENICE_API_KEY": "<your-venice-api-key>" }
    }
  }
}
常见配置路径：
宿主路径
Claude Desktop (macOS)~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows)%APPDATA%\Claude\claude_desktop_config.json
Cursor~/.cursor/mcp.json
LM Studiomcp.json（从应用的 MCP 设置中获取）
3

重启您的 MCP 宿主

您的 agent 现在已具备聊天、图像、视频、音乐、TTS、ASR 以及 25 个其他 Venice 工具。
大多数 MCP 宿主只会传递在 env 块中显式列出的环境变量。系统级环境变量不会被继承。如果您在设置了 API 密钥后仍看到 402 错误，请仔细检查 VENICE_API_KEY 是否在配置的 env 中。

​
您将获得

31 个工具，覆盖每种 Venice 模态；3 个资源（venice://models、venice://styles、venice://voices）；3 个 prompt 模板。

​
聊天与 embeddings

工具说明
venice_chat针对 Venice 完整 LLM 目录的 OpenAI 兼容聊天补全。
venice_responses支持单轮或多轮工具的 OpenAI 兼容 Responses API。
venice_embeddings计算文本输入的 embeddings。
venice_chat_with_character按 slug 与 Venice character 聊天。

​
图像

工具说明
venice_image_generate生成图像（Flux 2、Lustify SDXL、Anime/WAI、Qwen Image、GPT Image、Nano Banana Pro 等）。
venice_image_edit用 prompt 编辑图像。
venice_image_multi_edit用一个 prompt 同时编辑多张图像。
venice_image_upscale将图像放大至 4 倍。
venice_image_remove_bg移除图像背景。
venice_image_styles列出图像风格预设。

​
视频

工具说明
venice_video_generate排队视频生成（Sora 2、Veo 3.1、Kling、Wan、LTX 2、Seedance、Runway Gen-4 等）。
venice_video_status检查已排队视频作业的状态。
venice_video_complete将已完成视频标记为已下载；删除服务器端媒体。
venice_video_transcriptions转录 YouTube 视频 URL。
venice_video_quote在排队前获取价格报价。

​
音频（TTS / ASR）

工具说明
venice_tts文本转语音，支持克隆 voice 和情感标签。
venice_asr从 URL 转录音频。
venice_voice_clone列出内置 voice 或从样本克隆 voice。
venice_audio_quote获取音乐生成的价格报价。

​
音乐

工具说明
venice_music_generate排队音乐生成（ace-step-15、elevenlabs-music、minimax-music-v2/v25/v26、stable-audio-25、mmaudio-v2、elevenlabs-sound-effects-v2）。
venice_music_status检查已排队音乐作业的状态。
venice_music_complete将已完成音乐作业标记为已下载。

​
Web augment、目录和 crypto

工具说明
venice_web_search搜索 web（由 Firecrawl 支持）。
venice_web_scrape将一个 URL 抓取为 markdown。
venice_text_parser从 PDF/DOCX/EPUB/PPTX/XLSX 提取文本。
venice_list_models列出实时的模型目录与价格。
venice_list_characters列出公开的 Venice characters。
venice_crypto_rpc代理对 Base、Ethereum、Polygon、Arbitrum 或 Optimism 的 JSON-RPC 调用。

​
x402 钱包辅助

仅当您通过 x402 使用钱包而非 API 密钥进行身份验证时相关。
工具说明
venice_x402_balance检查 EVM 或 Solana 钱包地址的预付 x402 额度余额。
venice_x402_top_up_info获取充值要求（网络、USDC 代币、接收方、最低金额）。
venice_x402_transactions列出 EVM 或 Solana 钱包地址近期的 x402 充值和扣款交易。

​
配置

服务器完全通过环境变量配置。
环境变量默认值备注
VENICE_API_KEY(无)您的 Venice API 密钥。最简单的设置。
VENICE_DEFAULT_CHAT_MODELvenice-uncensored
VENICE_DEFAULT_IMAGE_MODELflux-2-pro
VENICE_DEFAULT_TTS_MODELtts-kokoro
VENICE_DEFAULT_ASR_MODELopenai/whisper-large-v3
VENICE_DISABLE_NSFW0设置为 1 可从工具描述中移除 NSFW 能力说明。
VENICE_HTTP_TIMEOUT_MS60000
VENICE_SIWX_TOKEN(无)x402 钱包模式身份验证 token。请参阅下方的 x402。
如果同时设置了 VENICE_API_KEY 和 VENICE_SIWX_TOKEN，API 密钥优先。

​
x402 钱包模式

除了正常的 API 密钥流程外，Venice 还支持使用由 Base 或 Solana 上预付 USDC 额度支持的 Sign-In-With-X 钱包 token进行身份验证。无需邮箱、电话或 KYC：您的钱包是唯一的身份。 
{
  "mcpServers": {
    "venice": {
      "command": "npx",
      "args": ["-y", "@veniceai/[email protected]"],
      "env": { "VENICE_SIWX_TOKEN": "<base64 Sign-In-With-X payload>" }
    }
  }
}
MCP 服务器在每次 Venice API 调用上将 VENICE_SIWX_TOKEN 作为 X-Sign-In-With-X 请求头转发。服务器永远看不到您的私钥。钱包签名和 USDC 充值授权在您自己的钱包中进行。
流程发生什么
一次性设置在钱包中签署一个 Sign-In-With-X 消息 → 产生一个 SIWX token（base64 JSON）。
充值POST /api/v1/x402/top-up 返回 402 + 付款要求。签署其中一个返回的 Base 或 Solana 选项的 USDC 付款，重新提交，Venice 即为您的余额充值。
每次推理调用MCP 服务器发送 X-Sign-In-With-X: <SIWX>；Venice 从您的预付余额中扣款。
最低充值为 $5 USD。调用推理的最低余额为 $0.10。充值后调用延迟低于 100ms，因为结算在一个快速额度账户上链下进行。
绑定到已质押 DIEM 的 Venice 账户的钱包将从质押余额而非 USDC 额度中消费，因此无需充值。

​
自托管（Streamable HTTP）

对于团队或工作区部署，通过 HTTP 而非 stdio 运行 MCP 服务器： 
docker run -p 3333:3333 \
  -e VENICE_API_KEY=<your-venice-api-key> \
  -e VENICE_MCP_AUTH_TOKEN=<choose-a-long-random-token> \
  ghcr.io/veniceai/venice-mcp-server:latest
服务器现在可在 http://localhost:3333/mcp 访问。HTTP 客户端必须发送 Authorization: Bearer <VENICE_MCP_AUTH_TOKEN>。
/mcp 是一个由凭证支持的工具执行端点：调用方可花费配置的 Venice API 密钥或 x402 余额。当 HTTP 模式绑定在 loopback 之外时，除非设置了 VENICE_MCP_AUTH_TOKEN，否则启动会失败。对于生产环境，请显式锁定 npm 包版本，而不是依赖 latest。

​
资源

GitHub

源代码、issues 和发布

npm

@veniceai/mcp-server

Venice Skills

教 agent 如何使用这些工具的配套 skills

MCP 规范

了解更多关于 Model Context Protocol