通过类型化 MCP 合约提供存储能力。
它为代理提供什么
一个专门为单个 MCP 连接设计的能力。
服务器拥有其领域逻辑,并发布 MCP 客户端可发现的工具契约。ADK-Rust 可将该契约加载到代理中,为所选模型提供者规范每个模式,并将连接生命周期保持在代理业务逻辑之外。
架构
mcp-storage 在代理系统中的作用。
模型无需了解服务器背后系统的实现细节或凭证。它看到审核过的工具定义。MCP 客户端负责发现和调用,服务器保持验证、策略和与领域系统的通信所有权。
ADK-Rust 代理
从审核过的工具目录中选择能力。
MCP 客户端
发现模式,发送调用,并接收类型化内容。
mcp-storage
验证请求并拥有 12 个已记录工具契约。
领域系统
维护服务器背后的 API、数据、凭证和业务规则。
本仓库当前未发布专用架构 SVG。上方集成图由其文档化的传输和服务器边界生成;具体实现细节请参阅官方 README。
工具目录
代理可以请求 mcp-storage 做什么?
每个工具都有稳定名称、易读的用途和 MCP 初始化时发现的 JSON 输入契约。风险类别来自项目的注册清单(如果有)。
12 个命名工具
list_buckets列出所有桶/容器
read onlylist_objects列出桶中的对象,可选前缀过滤
read onlyget_object_info获取对象元数据
read onlydownload_object下载对象内容
read onlygenerate_presigned_url生成临时访问 URL
read onlyupload_object上传内容到对象路径
internal writecopy_object在桶内或桶间复制对象
internal writemove_object移动对象(复制 + 删除源)
internal writedelete_object删除单个对象
internal writecreate_bucket创建新桶
internal writesearch_objects按前缀模式搜索对象
read onlyget_storage_usage获取桶的存储使用汇总
read only治理
了解每个工具的作用。
服务器连接继承其凭证和部署环境的权限。以下声明来自本项目的 README 和 MCP 注册清单;您的应用程序仍决定代理接收哪些工具以及何处需要批准。
- 写操作受控 — delete_object、move_object 和 create_bucket 在受管环境中需审批
- 预签名 URL 有效期 — 默认 1 小时,可按请求配置
- 响应中不包含密钥 — 凭证绝不回显
- 默认只读 — 浏览和下载工具不修改任何内容
MCP 接口
当前文档声明的内容。
MCP 可传输工具、资源、提示、结构化结果、进度、取消和长时间运行的工作。此记录突出显示本仓库明确提及的现代协议特性。
安装并连接
遵循项目文档中的起点。
在拥有凭证和领域访问权限的环境中安装服务器。将其添加到您的 MCP 主机,验证发现的工具,并在交付生产代理前缩小工具集。
cargo install mcp-storage{
"mcpServers": {
"storage": {
"command": "mcp-storage",
"env": {
"STORAGE_ENDPOINT": "https://storage.googleapis.com",
"STORAGE_ACCESS_KEY": "GOOG1E...",
"STORAGE_SECRET_KEY": "your-secret",
"STORAGE_REGION": "us-east-1"
}
}
}
}命令和配置从公开的 README 中提取。部署前请确认官方文档中的先决条件、环境变量和特定版本选项。
官方文档
继续使用项目维护者的权威信息源。
此页面提供服务器的易懂地图。仓库对确切的模式、先决条件、配置、示例、测试、版本和安全更新保持权威。
继续探索