RustFS MCP server 介绍

RustFS MCP，这是一个高性能的模型上下文协议 (Model Context Protocol, MCP)服务器。

核心功能与目的:

• 桥梁作用: RustFS MCP 充当 AI 助手（如 Claude Desktop）和 S3 兼容对象存储服务（如 RustFS、MinIO 等）之间的桥梁。
• 协议: 它基于开放标准 Model Context Protocol (MCP)，允许 AI 应用安全、受控地连接到外部系统（在此特指 S3 存储）。
• 目标: 使 AI 工具能够通过标准化协议无缝访问和操作 S3 兼容的对象存储。

主要特性:

• 支持的 S3 操作:
  • 列出存储桶 (List Buckets)
  • 浏览对象 (List Objects)，支持前缀过滤
  • 上传文件 (Upload Files)，自动检测 MIME 类型
  • 获取对象 (Get Objects)，支持直接读取内容或下载到本地文件
  • 创建存储桶 (Create Bucket)
  • 删除存储桶 (Delete Bucket)

安装与配置:

• 前提条件: 需要 Rust 1.75+ (如果从源码构建) 和已配置的 AWS 凭证 (通过环境变量、AWS CLI 或 IAM 角色)。
• 构建方式: 提供了从源码使用cargo build构建的方法。
• 配置方式:
  • 使用环境变量 (如AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY,AWS_REGION,AWS_ENDPOINT_URL)。
  • 使用命令行参数 (--access-key-id,--secret-access-key,--region,--endpoint-url等)。
• Docker 支持: 提供官方 Dockerfile，方便容器化部署。

使用方法:

• 启动服务器: 直接运行rustfs-mcp命令，可选择性地传入命令行选项。
• 集成 AI IDE: 可以通过配置 MCP 服务器的方式集成到支持 MCP 的 AI IDE/Chat 客户端中（例如 Cursor, Windsurf, Trae）。配置通常涉及指定执行命令（路径或docker run）和必要的环境变量或参数。
• AI 调用: 配置成功后，用户可以在 AI IDE 中通过自然语言提示（Prompt）来调用暴露出来的工具，例如要求 AI 列出存储桶或对象、上传文件等。

可用工具:

• 服务器向 AI 助手暴露了特定的工具函数，包括list_buckets,list_objects,upload_file,get_object,create_bucket,delete_bucket。每个工具都有其特定的参数。

架构:

• 采用模块化设计，主要包括入口点、MCP 服务器实现、S3 客户端封装、配置管理等组件。