Put.io 网盘 MCP 服务器

项目简介

本项目 'putio-mcp-server' 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在将 put.io 网盘的功能集成到支持 MCP 协议的 LLM 客户端中，例如 Claude Desktop。通过此服务器，LLM 可以调用预设的工具来管理您的 put.io 网盘，实现诸如查看正在进行的传输、添加新的传输任务、取消传输以及获取已完成传输的浏览器链接等功能。

主要功能点

查看活动传输列表: 允许 LLM 获取当前 put.io 账户中正在进行的传输任务列表。
添加新的传输: 支持通过 URL 或 Magnet 链接向 put.io 添加新的下载或传输任务。
取消传输: 可以根据传输 ID 取消指定的传输任务。
获取浏览器链接: 对于已完成的传输，可以获取一个可以直接在浏览器中打开的链接，方便用户访问下载内容。

安装步骤

安装 Python 3.x: 确保您的系统已安装 Python 3.x 环境。
安装 uvx: 根据 uvx 官方文档安装 'uvx'。 'uvx' 是一个快速的 Python 打包和运行工具，这里用于运行 MCP 服务器。
安装 put.io Python 客户端: 虽然文档没有明确指出，但根据代码推测可能需要安装 'putiopy' 库。可以使用 pip 安装：
```
pip install put.io
```
(实际上，'putiopy' 库名应为 'putio'，但为了与安装命令一致，这里写 'put.io'，实际安装时请使用 'pip install putio')
获取 Put.io API Token: 访问 put.io API Token 获取指南获取您的 put.io API Token。

服务器配置

要将 'putio-mcp-server' 配置到 MCP 客户端（例如 Claude Desktop），您需要编辑客户端的配置文件 'claude_desktop_config.json'，添加如下 'mcpServers' 配置。请将 '<your-putio-api-token>' 替换为您在安装步骤中获取的 put.io API Token。

{
  "mcpServers": {
    "putio": {  // 服务器名称，可以自定义，例如 "my_putio_server"
      "command": "uvx", // 启动服务器的命令，这里使用 uvx
      "args": [       // 命令参数，这里指定运行 putio-mcp-server
        "putio-mcp-server"
      ],
      "env": {        // 环境变量
        "PUTIO_TOKEN": "<your-putio-api-token>" //  put.io API Token，用于服务器认证
      }
    }
  }
}

配置说明:

'"putio"': 这是您为该 MCP 服务器定义的名称，在客户端中用于标识和调用此服务器提供的工具。您可以根据需要自定义名称。
'"command": "uvx"' 和 '"args": ["putio-mcp-server"]': 这两行配置指定了启动 MCP 服务器的命令。这里使用 'uvx putio-mcp-server' 来运行服务器。假设 'main.py' 文件名为 'putio-mcp-server.py'，并且与 'uvx' 命令在同一路径下或者在 'uvx' 可以找到的路径中。 (根据仓库信息推断，可能需要将 'main.py' 文件重命名为 'putio-mcp-server'，或者在包含 'main.py' 的目录下运行 'uvx main.py'，具体取决于 'uvx' 的运行机制和实际部署情况。但为了与 'README.md' 保持一致，这里使用 'putio-mcp-server')
'"env": {"PUTIO_TOKEN": "<your-putio-api-token>"}': 通过环境变量 'PUTIO_TOKEN' 将您的 put.io API Token 传递给服务器。这是安全地传递敏感信息的方式。

请注意： 确保您已将包含 'main.py' 文件的目录添加到系统的 PATH 环境变量中，或者在使用 'uvx' 命令时，在正确的目录下执行，以便 'uvx' 能够找到 'putio-mcp-server' (或 'main.py') 文件。此外，可能需要先使用 'uvx bundle' 命令将项目打包成可执行文件，然后再在 'command' 中指定打包后的文件名。具体操作请参考 'uvx' 的官方文档。为了简化配置，最简单的方式是将 'main.py' 文件重命名为 'putio-mcp-server' 并放在 'uvx' 能够直接执行的路径下。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，您应该能够看到名为 "putio" (或您在配置文件中设置的服务器名称) 的 MCP 服务器。您可以指示 LLM 调用此服务器提供的工具来管理您的 put.io 网盘。例如，在 Claude Desktop 中，您可以像这样指示：

'使用 putio 服务器的 list_transfers 工具查看当前传输列表'

或者

'使用 putio 服务器的 add_transfer 工具添加下载链接 [您的下载链接]'

LLM 客户端会解析您的指令，并调用 'putio-mcp-server' 提供的相应工具，然后将结果返回给您。具体的工具名称和参数请参考代码中的函数定义和 docstring。

关键词