使用说明
@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)
