Mixcloud MCP

混音室噪音大

让克劳德搜索混音、查找艺术家、浏览上传内容，并将录音直接上传到Mixcloud——所有这些都来自对话。

______________________________________________________________________

工具

______________________________________________________________________

快速入门--stdio（克劳德桌面，本地）

无需安装。添加到您的 claude_desktop_config.json 并重新启动：

雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mixcloud": {
      "command": "/path/to/uvx",
      "args": ["mixcloud-mcp"]
    }
  }
}

提示： Claude Desktop没有继承你的shell PATH，所以 uvx 必须是一条完整的路径。 跑 which uvx 在您的终端中查找它——通常 /Users/yourname/.local/bin/uvx.

公共只读工具（搜索、获取用户等）无需任何凭据即可立即工作。

启用上载和经过身份验证的API调用，添加您的Mixcloud OAuth应用程序凭据。服务器将在首次启动时打印一个授权URL到stderr——在浏览器中访问一次，您的令牌将自动保存。

{
  "mcpServers": {
    "mixcloud": {
      "command": "/path/to/uvx",
      "args": ["mixcloud-mcp"],
      "env": {
        "MIXCLOUD_CLIENT_ID": "",
        "MIXCLOUD_CLIENT_SECRET": ""
      }
    }
  }
}

在以下网址获取您的凭据 mixcloud.com/developers.注册 http://localhost:4000/oauth/callback 作为Mixcloud应用程序中的重定向URI。

______________________________________________________________________

快速入门-HTTP（托管服务器、远程MCP客户端）

HTTP传输通过网络公开服务器，以便远程MCP客户端（Claude.ai，配置了URL的Claude Desktop）可以连接到它。

1.注册Mixcloud OAuth应用程序

首选 mixcloud.com/developers 并创建一个应用程序。你会得到一个 客户端ID 和 客户端密钥.

将重定向URI设置为服务器的公共URL+ /oauth/callback:

https://your-server.example.com/oauth/callback

如果您使用ngrok在本地运行，请使用您的ngrok URL（请参阅步骤3）。

2.配置您的环境

创建一个 .env file（或将其设置为环境变量）：

MIXCLOUD_CLIENT_ID=your_client_id
MIXCLOUD_CLIENT_SECRET=your_client_secret
MCP_PUBLIC_URL=https://your-server.example.com   # public HTTPS URL — no port, no trailing slash
MCP_API_KEY=your_secret_key                       # protects the MCP endpoint; generate with mixcloud-mcp-keygen

MCP_PUBLIC_URL 是必需的。 它必须是HTTPS，并且与您在Mixcloud应用程序中注册为重定向URI的域相匹配。如果您通过ngrok在本地运行，这是您的ngrok URL（例如。 https://xxxx.ngrok-free.app).不要包含端口号——ngrok会为您处理端口映射。

可选： 如果您已经拥有Mixcloud访问令牌，请设置 MIXCLOUD_ACCESS_TOKEN 跳过步骤4。

3.启动服务器

uvx mixcloud-mcp-http

在启动时，你会看到一行类似于：

[http] No Mixcloud token — visit https://your-server.example.com/oauth/authorize to enable uploads.

如果您在本地运行，请先使用ngrok公开服务器：

ngrok http 8000

使用ngrok HTTPS URL作为 MCP_PUBLIC_URL 并确保在Mixcloud应用程序中将相同的URL注册为重定向URI。

4.使用Mixcloud进行身份验证

打开 https://your-server.example.com/oauth/authorize 在浏览器中打开并批准访问。服务器记录：

[http] Mixcloud token stored — upload tool is now authenticated.

令牌在进程的生命周期内保存在内存中。要在重新启动时保持它，请将令牌复制到 MIXCLOUD_ACCESS_TOKEN 在你的 .env.

5.在Claude中添加连接器

在克劳德，去 设置→ 连接器→ 添加自定义连接器 并输入：

https://your-server.example.com/mcp

URL必须以结尾 /mcp。仅使用基本URL是行不通的。

只读工具（搜索、浏览、获取用户）立即可用。在步骤4中通过Mixcloud验证后，上传工具即可使用。

______________________________________________________________________

环境变量

两种运输方式

仅限stdio

仅限HTTP

______________________________________________________________________

身份验证的工作原理

stdio——sidecar OAuth

当 MIXCLOUD_CLIENT_ID 和 MIXCLOUD_CLIENT_SECRET 如果设置了，服务器将启动一个轻量级sidecar HTTP服务器（在 UPLOAD_PORT，默认值4000）。在第一次运行时，如果没有令牌，它会打印：

[mixcloud-mcp] No Mixcloud token — visit http://localhost:4000/oauth/authorize to connect your account.

在浏览器中访问该URL一次，批准访问Mixcloud，您的令牌将写入 .env 并立即捡起。您不需要重新启动服务器。

sidecar还处理文件上传——上传UI直接发布到 http://localhost:4000/upload.

HTTP——服务器级身份验证

HTTP服务器向Mixcloud进行一次身份验证，并在所有连接的MCP客户端之间共享该令牌。没有每个用户的令牌——首先进行身份验证的人会在进程的生命周期内设置令牌。

您可以通过两种方式提供令牌（请参阅上面的快速入门）：预设 MIXCLOUD_ACCESS_TOKEN 在您的环境中，或访问 /oauth/authorize 启动服务器后，在浏览器中。在这两种情况下，只读工具始终可供任何具有以下功能的客户端使用 MCP_API_KEY；一旦Mixcloud令牌存在，上传就可用。

在Mixcloud应用程序中注册的重定向URI必须为 /oauth/callback.

______________________________________________________________________

未来想法

• HTTP模式下的每个用户会话 --目前，所有MCP客户端共享一个Mixcloud令牌。会话层将允许每个用户独立进行身份验证，并上传到他们自己的Mixcloud帐户。

______________________________________________________________________

贡献

看 贡献.md.

______________________________________________________________________

许可证

GNU通用公共许可证v3.0