qBittorrent MCP server CLI | TypeScript WebUI API binding
接入配置
选择客户端，复制配置，再按项目文档补齐环境变量。
claude mcp add nqbtc --env QBITTORRENT_WEBUI_BASE_URL='<QBITTORRENT_WEBUI_BASE_URL>' -- npx nqbtc mcp '--base-url={{config.QBITTORRENT_WEBUI_BASE_URL}}' '--username={{config.QBITTORRENT_WEBUI_USERNAME}}' '--password={{config.QBITTORRENT_WEBUI_PASSWORD}}'~/.codex/config.toml
[mcp_servers.nqbtc]
command = "npx"
args = ["nqbtc", "mcp", "--base-url={{config.QBITTORRENT_WEBUI_BASE_URL}}", "--username={{config.QBITTORRENT_WEBUI_USERNAME}}", "--password={{config.QBITTORRENT_WEBUI_PASSWORD}}"]
env = { QBITTORRENT_WEBUI_BASE_URL = "<QBITTORRENT_WEBUI_BASE_URL>" }
# codex mcp add nqbtc --env QBITTORRENT_WEBUI_BASE_URL='<QBITTORRENT_WEBUI_BASE_URL>' -- npx nqbtc mcp '--base-url={{config.QBITTORRENT_WEBUI_BASE_URL}}' '--username={{config.QBITTORRENT_WEBUI_USERNAME}}' '--password={{config.QBITTORRENT_WEBUI_PASSWORD}}'~/.cursor/mcp.json
{
"mcpServers": {
"nqbtc": {
"command": "npx",
"args": [
"nqbtc",
"mcp",
"--base-url={{config.QBITTORRENT_WEBUI_BASE_URL}}",
"--username={{config.QBITTORRENT_WEBUI_USERNAME}}",
"--password={{config.QBITTORRENT_WEBUI_PASSWORD}}"
],
"env": {
"QBITTORRENT_WEBUI_BASE_URL": "<QBITTORRENT_WEBUI_BASE_URL>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"nqbtc": {
"type": "stdio",
"command": "npx",
"args": [
"nqbtc",
"mcp",
"--base-url={{config.QBITTORRENT_WEBUI_BASE_URL}}",
"--username={{config.QBITTORRENT_WEBUI_USERNAME}}",
"--password={{config.QBITTORRENT_WEBUI_PASSWORD}}"
],
"env": {
"QBITTORRENT_WEBUI_BASE_URL": "<QBITTORRENT_WEBUI_BASE_URL>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"nqbtc": {
"command": "npx",
"args": [
"nqbtc",
"mcp",
"--base-url={{config.QBITTORRENT_WEBUI_BASE_URL}}",
"--username={{config.QBITTORRENT_WEBUI_USERNAME}}",
"--password={{config.QBITTORRENT_WEBUI_PASSWORD}}"
],
"env": {
"QBITTORRENT_WEBUI_BASE_URL": "<QBITTORRENT_WEBUI_BASE_URL>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"nqbtc": {
"command": "npx",
"args": [
"nqbtc",
"mcp",
"--base-url={{config.QBITTORRENT_WEBUI_BASE_URL}}",
"--username={{config.QBITTORRENT_WEBUI_USERNAME}}",
"--password={{config.QBITTORRENT_WEBUI_PASSWORD}}"
],
"env": {
"QBITTORRENT_WEBUI_BASE_URL": "<QBITTORRENT_WEBUI_BASE_URL>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"nqbtc": {
"command": "npx",
"args": [
"nqbtc",
"mcp",
"--base-url={{config.QBITTORRENT_WEBUI_BASE_URL}}",
"--username={{config.QBITTORRENT_WEBUI_USERNAME}}",
"--password={{config.QBITTORRENT_WEBUI_PASSWORD}}"
],
"env": {
"QBITTORRENT_WEBUI_BASE_URL": "<QBITTORRENT_WEBUI_BASE_URL>"
}
}
}
}需要的环境变量
QBITTORRENT_WEBUI_BASE_URL
把占位值换成你自己的密钥；不要把密钥提交到代码仓库。