Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client