文件上传服务

一个基于MCP协议的文件上传服务,可将本地文件上传至S3兼容存储并生成可共享的URL链接。

  • by zhigang1992
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 zhigang1992/upload-mcp

使用说明

@zhigang1992/uploadfile-mcp 翻译为中文是:“@zhigang1992/上传文件-MCP(可能指某种特定配置或模式)”。不过,这里的“MCP”在没有具体上下文的情况下,可能是一个特定项目、配置或模式的缩写,因此直接翻译为“MCP”可能不够准确。如果“MCP”有特定的含义或上下文,请根据实际情况进行调整。

一个MCP(模型上下文协议)服务器,允许您将本地文件上传到兼容S3的存储服务,并获取可共享的URL。

安装

全球安装

npm install -g @zhigang1992/uploadfile-mcp

本地安装

npm install @zhigang1992/uploadfile-mcp

使用方法

直接使用 npx 运行

npx @zhigang1992/uploadfile-mcp

添加到Claude Desktop

把这个加到你的 claude_desktop_config.json:

{
  "mcpServers": {
    "upload-file": {
      "command": "npx",
      "args": ["@zhigang1992/uploadfile-mcp"]
    }
  }
}

可用工具

upload_file

将本地文件上传到兼容S3的存储服务,并获取一个可共享的URL。文件会自动组织在具有唯一UUID的文件夹中,以避免命名冲突。

参数:

  • file_path (必需):要上传的文件的本地路径

示例用法:

{
  "file_path": "/path/to/local/file.jpg"
}

返回:

{
  "success": true,
  "file_path": "/path/to/local/file.jpg",
  "folder_id": "e4847e59-2003-443c-bd47-775fc6b6a195",
  "original_filename": "file.jpg",
  "remote_path": "e4847e59-2003-443c-bd47-775fc6b6a195/file.jpg",
  "url": "https://s3.reily.app/public/e4847e59-2003-443c-bd47-775fc6b6a195/file.jpg",
  "message": "File uploaded successfully to https://s3.reily.app/public/e4847e59-2003-443c-bd47-775fc6b6a195/file.jpg"
}

注: 每个上传的文件都被放置在一个基于唯一标识符(UUID)的唯一文件夹中,以避免命名冲突,同时保留原始文件名。

发展

安装依赖项:

bun install

在开发环境中运行:

bun run dev

为分发构建(或:准备分发版本):

bun run build

配置

这个MCP服务器使用的是与S3兼容的终端节点,位于 https://s3.reily.app 并将文件上传至 public 存储桶。上传的文件可公开访问。

许可证

麻省理工学院(MIT)