返回 MCP 目录
public公开dns本地运行

Upload File

基于MCP协议的文件上传服务工具

article

README

🚀 MCP 上传文件

一个基于 MCP (模型上下文协议) 的文件上传服务,为文件上传提供便捷解决方案。

🚀 快速开始

✨ 主要特性

本服务基于 MCP 协议,可方便地进行文件上传配置。

📦 安装指南

在 MCP 配置文件中添加以下配置:

{
  "mcpServers": {
    "upload-file": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-upload-file@latest"
      ],
      "env": {
        "UPLOAD_URL": "",        // 文件上传的目标 URL
        "FILE_KEY": "",          // 上传表单中文件字段的 key 名称
        "FILE_NAME": "",         // 上传的文件名
        "EXTRA_FORM": "{\"other_form_key\":\"other_form_value\"}"  // 额外的表单数据(JSON 格式)
      }
    }
  }
}

🔧 技术细节

环境变量说明

| 属性 | 详情 | |------|------| | UPLOAD_URL | 必填项,文件上传的目标 URL 地址 | | FILE_KEY | 必填项,上传表单中文件字段的 key 名称 | | FILE_NAME | 可选项,指定上传文件的文件名 | | EXTRA_FORM | 可选项,额外的表单数据,需要是合法的 JSON 格式字符串 |

⚠️ 重要提示

请确保 UPLOAD_URLFILE_KEY 为必填项,且 EXTRA_FORM 为合法的 JSON 格式字符串。

💡 使用建议

若需要指定上传文件的文件名,可填写 FILE_NAME;若有额外的表单数据,可通过 EXTRA_FORM 进行配置。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端