mcp-upload-file

mcp-upload-file

site icon
2025.03.18 1
JavaScript文件上传文件管理文件管理
mcp-upload-file 是一个基于 MCP (Model Context Protocol) 的文件上传服务,主要用于文件的上传和管理。它允许用户通过配置环境变量来指定上传的目标 URL、文件字段的 key、文件名以及额外的表单数据。
View on GitHub

Overview

基本能力

产品定位

mcp-upload-file 是一个文件上传服务,基于 MCP (Model Context Protocol) 实现,主要用于文件的上传和管理。

核心功能

  • 支持文件上传到指定的 URL。
  • 可配置上传表单中文件字段的 key。
  • 支持指定上传文件的文件名。
  • 允许添加额外的表单数据(JSON 格式)。

适用场景

  • 需要将文件上传到指定服务器的场景。
  • 需要动态配置上传参数(如 URL、文件字段 key 等)的场景。
  • 需要在上传文件时附带额外表单数据的场景。

工具列表

  • npx: 用于运行 mcp-upload-file 服务。

常见问题解答

  • 如何配置上传的目标 URL? 在环境变量中设置 UPLOAD_URL
  • 如何指定上传文件的文件名? 在环境变量中设置 FILE_NAME
  • 如何添加额外的表单数据? 在环境变量中设置 EXTRA_FORM,并确保其为合法的 JSON 字符串。

使用教程

使用依赖

  • 确保已安装 Node.js 和 npm/npx。

安装教程

  1. 在 MCP 配置文件中添加以下配置:
{
  "mcpServers": {
    "upload-file": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-upload-file@latest"
      ],
      "env": {
        "UPLOAD_URL": "",
        "FILE_KEY": "",
        "FILE_NAME": "",
        "EXTRA_FORM": "{\"other_form_key\":\"other_form_value\"}"
      }
    }
  }
}
  1. 根据实际需求填写环境变量 UPLOAD_URLFILE_KEYFILE_NAMEEXTRA_FORM

调试方式

  1. 确保配置文件中的环境变量已正确设置。
  2. 运行服务后,检查上传是否成功以及返回的响应是否符合预期。

许可证

None