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)ocd ~/.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 main3. 检查它的工作原理
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 install2. 设置凭据
创建文件 .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_QUI3. 使用本地路径配置
反重力 (~/.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_URLeN8N_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.jsAPI密钥错误
请确保:
- 关键从
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是否为 公共
- 检查仓库名称是否正确
- 尝试本地安装作为替代方案
______________________________________________________________________
📄 许可证
麻省理工学院
