使用说明

VoiceForge MCP客户端

用于管理 VoiceForge AI 代理的 MCP 客户端光标, **反重力（双子座）**或任何兼容 MCP 的助手。

🚀 快速开始

1. 获取您的API密钥

瓦伊ahttps://voiceforge.super-chatbot.com
注册或登录
仪表盘→ API密钥 创建新密钥
复制密钥（从 vf_...)

2. 设置您的助手

💡 只安装你使用的东西 （反重力O光标，非entrambi）

反重力（双子座）

添加到 ~/.gemini/antigravity/mcp_config.json:

{
  "mcpServers": {
    "voiceforge": {
      "command": "npx",
      "args": ["-y", "github:almai1/mcp-server-eleven"],
      "env": {
        "VOICEFORGE_API_KEY": "vf_LA_TUA_API_KEY_QUI"
      }
    }
  }
}

光标

添加到 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "voiceforge": {
      "command": "npx",
      "args": ["-y", "github:almai1/mcp-server-eleven"],
      "env": {
        "VOICEFORGE_API_KEY": "vf_LA_TUA_API_KEY_QUI"
      }
    }
  }
}

📝 如何添加MCP服务器

步骤 1: 找到配置文件

MCP 配置文件位于不同的位置，具体取决于您的操作系统和 IDE：

反重力（双子座）：

视窗: C:\Users\TuoUtente\.gemini\antigravity\mcp_config.json
macOS/Linux: ~/.gemini/antigravity/mcp_config.json

光标：

视窗: C:\Users\TuoUtente\.cursor\mcp.json
macOS/Linux: ~/.cursor/mcp.json

💡 快速查找文件:

Windows：打开文件浏览器并键入 %USERPROFILE%\.gemini\antigravity 在地址栏中

macOS/Linux：打开终端并使用 open ~/.gemini/antigravity （macOS）o cd ~/.gemini/antigravity （Linux）

步骤 2: 创建或修改文件

搜索文件 不存在使用此内容创建：

根据反重力 (mcp_config.json):

{
  "mcpServers": {
    "voiceforge": {
      "command": "npx",
      "args": ["-y", "--", "github:almai1/mcp-server-eleven"],
      "env": {
        "VOICEFORGE_API_KEY": "vf_LA_TUA_API_KEY_QUI"
      }
    }
  }
}

按光标 (mcp.json):

{
  "mcpServers": {
    "voiceforge": {
      "command": "npx",
      "args": ["-y", "--", "github:almai1/mcp-server-eleven"],
      "env": {
        "VOICEFORGE_API_KEY": "vf_LA_TUA_API_KEY_QUI"
      }
    }
  }
}

搜索文件 已经存在添加 "voiceforge" 在 "mcpServers":

{
  "mcpServers": {
    "altro-server": {
      // ... configurazione esistente
    },
    "voiceforge": {
      "command": "npx",
      "args": ["-y", "--", "github:almai1/mcp-server-eleven"],
      "env": {
        "VOICEFORGE_API_KEY": "vf_LA_TUA_API_KEY_QUI"
      }
    }
  }
}

步骤 3: 获取您的 API 密钥

瓦伊苏https://voiceforge.super-chatbot.com
注册或登录
还是 仪表盘 → API密钥
点击 创建新密钥
复制密钥（从 vf_...)
替换 vf_LA_TUA_API_KEY_QUI 在配置文件中

步骤 4：重新启动 IDE

完全关闭并重新打开 Antigravity 或 Cursor 以加载 MCP 服务器。

步骤 5: 检查安装

通过询问您的助理测试服务器：

“列出我的 VoiceForge 代理人”

如果您收到包含代理列表的回复（或尚未收到的消息），则服务器配置正确！（2）✅

🔄 n8n集成（可选 - 推荐）

要管理 n8n 工作流程，请使用 服务器MCP n8n专用 与 VoiceForge 一起享受即插即用体验：

多服务器配置

添加 两个服务器 到您的配置文件：

反重力 (~/.gemini/antigravity/mcp_config.json):

{
  "mcpServers": {
    "voiceforge": {
      "command": "npx",
      "args": ["-y", "--", "github:almai1/mcp-server-eleven"],
      "env": {
        "VOICEFORGE_API_KEY": "vf_LA_TUA_API_KEY_QUI"
      }
    },
    "n8n": {
      "command": "npx",
      "args": ["-y", "n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://n8n.example.com/api/v1",
        "N8N_API_KEY": "LA_TUA_N8N_API_KEY_QUI"
      }
    }
  }
}

光标 (~/.cursor/mcp.json):

{
  "mcpServers": {
    "voiceforge": {
      "command": "npx",
      "args": ["-y", "--", "github:almai1/mcp-server-eleven"],
      "env": {
        "VOICEFORGE_API_KEY": "vf_LA_TUA_API_KEY_QUI"
      }
    },
    "n8n": {
      "command": "npx",
      "args": ["-y", "n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://n8n.example.com/api/v1",
        "N8N_API_KEY": "LA_TUA_N8N_API_KEY_QUI"
      }
    }
  }
}

⚠️ n8n的重要说明:

美国 N8N_API_URL （非 N8N_BASE_URLn8n-mcp 服务器

URL必须包含 /api/v1 最后

对于本地实例： http://localhost:5678/api/v1

为什么是两台服务器？

✅ 责任分离VoiceForge管理AI代理，n8n管理工作流程 ✅ 简化维护每个服务器都是独立更新的
✅ 灵活性您只能使用 VoiceForge，或在需要时添加 n8n ✅ 毫无麻烦的两者都可以“开箱即用”而无需复杂的配置

测试

重新启动向导并尝试：

VoiceForge：

“列出我的 VoiceForge 代理人”

n8n（se配置）：

“列出可用的n8n工作流程”

📖 文档 n8n-mcp: https://github.com/czlonkowski/n8n-mcp

📦 部署su GitHub

如果您想将 MCP 服务器发布到 GitHub npx:

1. 创建仓库

cd voiceforge-mcp
git init
git add .
git commit -m "Initial commit: VoiceForge MCP server"

2. 发布到GitHub

# Crea il repo su GitHub, poi:
git remote add origin https://github.com/TUO_USERNAME/mcp-server-eleven.git
git branch -M main
git push -u origin main

3. 检查它的工作原理

npx -y github:TUO_USERNAME/mcp-server-eleven

💡 repo必须是公共要使用 npx github:...

🔧 本地安装（可选）

如果您希望在本地运行服务器：

1. 克隆并安装

git clone https://github.com/almai1/mcp-server-eleven.git
cd mcp-server-eleven
npm install

2. 设置凭据

创建文件 .env 从这个例子开始：

# Linux/Mac
cp .env.example .env

# Windows
copy .env.example .env

然后修改 .env 您的凭据：

# REQUIRED: API Key VoiceForge
VOICEFORGE_API_KEY=vf_LA_TUA_API_KEY_QUI

# OPTIONAL: Solo se usi n8n
N8N_BASE_URL=https://tuo-dominio.com/api/v1
N8N_API_KEY=LA_TUA_N8N_API_KEY_QUI

3. 使用本地路径配置

反重力 (~/.gemini/antigravity/mcp_config.json):

{
  "mcpServers": {
    "voiceforge": {
      "command": "node",
      "args": ["/percorso/completo/mcp-server-eleven/index.js"]
    }
  }
}

💡 **环境变量从文件中加载 .env**因此，不需要在config中重复！

Windows示例：

{
  "mcpServers": {
    "voiceforge": {
      "command": "node",
      "args": ["C:/Users/TuoUtente/mcp-server-eleven/index.js"]
    }
  }
}

📦 原始MCP

资源

乐资源为AI模型提供文档背景。

URI	描述
`agents://list` 所有用户代理的列表
`docs://api`	VoiceForge API 文档
`docs://agents` 创建复杂代理的指南

在 Antigravity/Cursor 中使用示例：

> Leggi la documentazione API (usa resource docs://api)
> Mostrami la lista degli agenti (usa resource agents://list)

提示

一、提示它们是可重复使用的模板，用于创建代理。

名称	描述	参数
`create-customer-service-agent`	Crea客服	公司名称、行业、语言
`create-appointment-agent`	创建预订代理	businessName， serviceType， workingHours
`create-school-agent`	创建学校代理	teacherName， subject

在 Antigravity/Cursor 中使用示例：

> Usa il prompt create-customer-service-agent per PizzaExpress nel settore food
> Crea un agente scolastico con create-school-agent per Prof. Rossi (Matematica)

🛠️ 可用工具（50+）

👤 代理

工具	描述
`list_agents` 列出所有代理人
`get_agent` 一个代理人的细节
`create_agent` 创建新代理
`update_agent` 修改代理。
`delete_agent` 删除代理。

📚 知识库

工具	描述
`list_knowledge`	Lista知识库
`add_knowledge_text` 添加文本
`add_knowledge_url` 添加URL。

💬 聊天

工具	描述
`chat` 发送消息给代理人

📅 日历

工具	描述
`list_calendar_events` 事件列表
`create_calendar_event` 创建事件
`update_calendar_event` 修改事件
`delete_calendar_event` 删除事件。
`list_calendar_users` 日历用户列表
`add_calendar_user` 添加用户
`update_calendar_user` 修改用户
`remove_calendar_user` 删除用户

🔗 网络钩子

工具	描述
`list_webhooks` webhooks列表。
`create_webhook` 创建 webhook
`update_webhook` 修改 webhook
`delete_webhook` 删除 webhook。
`test_webhook` 测试网站。

⚙️ 工作流程（VoiceForge）

工具	描述
`list_workflows`	Lista工作流
`get_workflow` 详细工作流程
`create_workflow`	Crea工作流程
`update_workflow`	修改工作流
`delete_workflow`	Elimina工作流程
`execute_workflow`	Esegui工作流程
`publish_workflow` 公开版本

🔄 n8n工作流

需要配置: N8N_BASE_URL e N8N_API_KEY

工具	描述
`list_n8n_workflows` 按代理列出n8n工作流程。
`get_n8n_workflow` n8n 工作流程详情
`create_n8n_workflow`	Crea工作流程n8n （使用节点格式指令）
`update_n8n_workflow` 修改现有的 n8n 工作流程
`delete_n8n_workflow`	Elimina工作流程n8n
`activate_n8n_workflow`	Attiva工作流程n8n
`deactivate_n8n_workflow`	Disattiva工作流n8n
`execute_n8n_workflow` 手动执行 n8n 工作流程。
`get_n8n_execution`	执行状态/结果
`list_n8n_executions` 最近执行的列表

创建 n8n 工作流的示例：

> Crea un workflow n8n per l'agente [ID] che riceve webhook POST su /test-webhook e risponde con {"success": true}

🔌 集成

工具	描述
`list_integrations` 整合列表
`get_integration` 集成细节
`create_integration` 配置整合。
`update_integration` 修改整合。
`delete_integration` 消除整合。

📊 分析

工具	描述
`get_analytics` 统计与报告。

🔑 API密钥

工具	描述
`list_api_keys`	列出API密钥
`create_api_key` 创建新密钥
`revoke_api_key`	Revoca密钥

🎤 声音

工具	描述
`list_voices` 可用条目列表。
`get_voice` 详细的声音。
`clone_voice` 克隆音频。
`update_voice_settings` 修改设置
`delete_voice` 删除声音。

🔊 TTS/STT

工具	描述
`generate_speech`	文本转语音
`transcribe_audio`	语音转文本

📞 电话

工具	描述
`list_phone_numbers` 数字列表。
`configure_phone_number`	配置编号

👥 团队

工具	描述
`list_teams` 列出团队。
`create_team`	Crea团队
`add_team_member` 添加会员
`remove_team_member` 删除会员。

🏢 组织

工具	描述
`list_organizations` 组织名单
`get_organization` 组织详情

🔧 代理工具

工具	描述
`list_agent_tools` 工具列表
`configure_agent_tool` 设置工具。

🖼️ 小部件

工具	描述
`get_widget_config`	配置小部件
`update_widget_config` 自定义 Widget

💬 使用范例

VoiceForge代理

“为说意大利语的旅行社创建客户服务代理”

“向知识库添加来自 www.example.com 的常见问题解答”

“更新代理系统提示符以使其更加正式”

n8n工作流（se配置）

“代理 [ID] 的 n8n 列表和工作流程”

“创建一个接收 POST webhook 并将数据发送到 Slack 的 n8n 工作流”

“为代理 [AGENT_ID] 启用 n8n [WORKFLOW_ID] 工作流”

“显示上次运行工作流 [WORKFLOW_ID] 的状态”

🐛 故障排除

服务器未加载

检查配置文件的路径：
- 反重力： ~/.gemini/antigravity/mcp_config.json
- 光标： ~/.cursor/mcp.json
完全重新启动 IDE 修改配置后

手动测试服务器：

# Con variabile d'ambiente
VOICEFORGE_API_KEY=vf_... node index.js

# Oppure con file .env (installazione locale)
cd /path/to/mcp-server-eleven
# Assicurati che il file .env esista con le credenziali
node index.js

API密钥错误

请确保：

关键从 vf_
La key sia validahttps://voiceforge.super-chatbot.com/api-keys)
用于安装 npx：变量 VOICEFORGE_API_KEY 在 JSON 文件中配置
对于本地安装：文件 .env 存在并包含 VOICEFORGE_API_KEY=vf_...

错误n8n:401未经授权

如果您在调用 tools n8n 时收到 401 错误：

检查 N8N_API_KEY 已配置
- 每 npx添加到 env JSON 配置文件
- 对于本地安装：将其添加到文件中 .env
检查 N8N_BASE_URL 包括 /api/v1
- ✅ 正确： https://n8n.example.com/api/v1
- ❌ 错误： https://n8n.example.com
重新启动 Antigravity/Cursor 修改配置后

找不到 GitHub 仓库

硒 npx github:... 失败：

检查repo是否为公共
检查仓库名称是否正确
尝试本地安装作为替代方案

📄 许可证

麻省理工学院