Medux

Medux MCP 服务

将 AI 助手连接到 Medux，用于 AI 媒体生成和编辑：视频、图像、语音、语音克隆、虚拟形象，以及 PDF/音频/视频工具。

• 端点（可流式传输的 HTTP）：https://medux.io/api/mcp/v1
• 身份验证：Authorization: Bearer sk-medux-...
• 工具：60+（生成、编辑、转换、任务查询）

1. 获取 API 密钥

在 Medux 账户中创建 API 密钥（以 sk-medux- 开头）：https://medux.io。 请妥善保管；不要将其提交到代码库。

2. GitHub Copilot / VS Code

需要使用已登录 GitHub Copilot 的 VS Code，并在 Agent 模式下使用 Copilot Chat。

1. 在命令面板中运行 MCP: Open User Configuration（⇧⌘P / Ctrl+Shift+P）。

2. 添加服务：

   {
     "servers": {
       "medux": {
         "type": "http",
         "url": "https://medux.io/api/mcp/v1",
         "headers": { "Authorization": "Bearer ${input:medux-api-key}" }
       }
     },
     "inputs": [
       { "type": "promptString", "id": "medux-api-key", "description": "Medux API key", "password": true }
     ]
   }
   

3. 在 MCP Servers 列表中，点击 medux 旁边的齿轮图标，然后选择 Start Server（或 Restart Server）。

4. 在 Copilot Chat（Agent 模式）中打开工具选择器，并确认列表中显示 medux 工具。

5. 先尝试一个无害的请求，例如：“使用 medux 列出你能做什么”。

如果始终没有出现密钥提示

在某些配置中，VS Code 不会显示 ${input:...} 提示，工具调用会以 Canceled 或 401 结束。 请将标头值直接替换为你的密钥，并写入用户级别的 mcp.json（绝不要写入代码库）：

"headers": { "Authorization": "Bearer sk-medux-xxxxxxxx" }

然后重启服务。

故障排除

症状	可能原因
401 / 未授权	缺少 Bearer 前缀，密钥错误或已撤销
每次调用都显示 Canceled: Canceled	未响应密钥提示；请使用上面的直接填写标头形式
404 和 NOT_FOUND	请求已到达 Medux；任务或资源 ID 不存在
服务未列出	检查 MCP: Open User Configuration 是否已正确保存；点击齿轮 → Show Output 查看日志

注册表

通过 .github/workflows/publish-mcp.yml（GitHub OIDC）以 io.github.MeduxIO/medux 的名称发布到 MCP Registry。 要发布新版本：更新 server.json 中的 version，然后运行工作流或推送 v* 标签。

许可证

MIT