tced-mcp

腾讯云企业网盘 的 MCP (Model Context Protocol) Server，让 AI 助手直接管理你的企业网盘文件。

支持 Claude Desktop、Cursor、CodeBuddy 等所有兼容 MCP 协议的 AI 客户端。

✨ 功能

• 🔐 OAuth2 授权登录 — 浏览器一键授权，安全便捷
• 👥 多账号管理 — 支持多个网盘账号登录与切换
• 📁 空间管理 — 个人空间、企业空间、协作空间自由切换
• 📂 目录浏览 — 列出目录内容，支持排序与筛选
• 🔍 文件搜索 — 按名称、类型、标签等维度搜索文件
• ⬆️ 文件上传 — 上传本地文件到云端，智能处理同名冲突
• ⬇️ 文件下载 — 下载云端文件到本地，支持历史版本
• ℹ️ 文件详情 — 查看文件/目录的详细元信息

🚀 快速开始

前置条件

• Node.js >= 18.0.0
• 一个腾讯云企业网盘账号

在 Claude Desktop 中使用

编辑 Claude Desktop 配置文件：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tced-mcp": {
      "command": "npx",
      "args": ["-y", "tced-mcp"]
    }
  }
}

在 Cursor 中使用

在项目根目录创建 .cursor/mcp.json：

{
  "mcpServers": {
    "tced-mcp": {
      "command": "npx",
      "args": ["-y", "tced-mcp"]
    }
  }
}

在 CodeBuddy 中使用

编辑 MCP 配置文件（~/.codebuddy/mcp.json）：

{
  "mcpServers": {
    "tced-mcp": {
      "command": "npx",
      "args": ["-y", "tced-mcp"]
    }
  }
}

全局安装使用

npm install -g tced-mcp

然后在 MCP 客户端配置中将 command 改为 tced-mcp，并移除 args。

📖 使用指南

1. 登录授权

首次使用时，让 AI 助手调用 login 工具。浏览器会自动打开企业网盘授权页面，登录并同意授权后自动完成配置。

登录态会持久化到 ~/.tced-mcp/auth.json，下次启动自动恢复，无需重复登录。

2. 选择空间

授权后需要选择要操作的空间：

• list_authorized_spaces — 查看已授权的空间列表
• switch_space — 切换到目标空间

3. 文件操作

选择空间后即可进行文件操作：

• list_directory — 列出目录内容
• file_info — 查看文件/目录详情
• search_files — 搜索文件
• upload_file — 上传文件
• download_file — 下载文件

🛠️ 完整工具列表

认证工具

| 工具 | 说明 | |------|------| | login | 发起 OAuth2 授权登录，自动唤起浏览器 | | logout | 登出指定账号或当前账号 | | list_accounts | 列出所有已登录的账号 | | switch_account | 切换当前活跃账号 | | current_account | 查看当前账号详细信息 |

空间工具

| 工具 | 说明 | |------|------| | list_authorized_spaces | 列出所有已授权的空间 | | switch_space | 切换到指定空间 | | current_space | 查看当前空间详细信息 |

文件工具

| 工具 | 说明 | |------|------| | upload_file | 上传本地文件到云端 | | download_file | 下载云端文件到本地 | | file_info | 查看文件或目录的详细信息 | | list_directory | 列出目录下的文件和子目录 | | search_files | 搜索当前空间中的文件和目录 |

⚙️ 环境变量

| 变量 | 说明 | 默认值 | |------|------|--------| | TCED_PAN_DOMAIN | 网盘域名 | https://pan.tencent.com | | TCED_BASE_PATH | API 基础路径 | https://api.tencentsmh.cn |

配置示例：

{
  "mcpServers": {
    "tced-mcp": {
      "command": "npx",
      "args": ["-y", "tced-mcp"],
      "env": {
        "TCED_PAN_DOMAIN": "https://your-custom-domain.com",
        "TCED_BASE_PATH": "https://your-api-endpoint.com"
      }
    }
  }
}

🔒 安全说明

• 本项目使用 OAuth2 授权码流程，用户需在浏览器中手动授权，MCP Server 不接触用户密码
• OAuth App 权限范围限定为 FILE.ALL（文件操作），不涉及管理员操作
• Token 持久化存储在本地 ~/.tced-mcp/auth.json，仅用户本人可访问
• AccessToken 过期后自动通过 RefreshToken 续期，无需重复授权

📄 License

MIT