能力标签

🔌 MCP 🔄 工作流 🐳 Docker 💻 CLI 🔗 REST API 🧠 Claude

🔌

MCP工具

Sairo

基于 Python · 让 AI 助手直接操作你的系统与工具

英文名：sairo

⭐ 14 Stars 🍴 1 Forks 💻 Python 📄 Apache-2.0 🏷 AI 8.0分

8.0AI 综合评分

mcpbackblaze-b2cloudflare-r2cost-optimization

⬇ 下载源码 ZIP ⚙️ 配置说明

✦ AI Skill Hub 推荐

Sairo 是 AI Skill Hub 本期精选MCP工具之一。综合评分 8.0 分，整体质量较高。我们强烈推荐将其纳入你的 AI 工具库，帮助提升工作效率。

📚 深度解析

Sairo 是一款基于 MCP（Model Context Protocol）标准协议的 AI 工具扩展。MCP 协议由 Anthropic 开发并开源，旨在建立 AI 模型与外部工具之间的标准化通信接口，目前已被 Claude Desktop、Claude Code、Cursor 等主流 AI 工具采纳。

通过安装 Sairo，你的 AI 助手将获得额外的工具调用能力，可以用自然语言直接操控该工具的功能，无需学习复杂的命令行语法。MCP 工具的核心价值在于"一次配置，永久增强"——配置完成后，每次与 AI 对话时都可以无缝调用这些工具。

在技术实现上，MCP 工具通过标准的 JSON-RPC 协议与 AI 客户端通信，工具的功能以"工具列表"的形式暴露给 AI 模型，AI 可以按需调用。Sairo 提供了结构化的工具调用接口，使 AI 模型能够精确地理解和使用每个功能点，显著降低 AI 在工具使用上的错误率。

与传统的 API 集成相比，MCP 工具的优势在于无需编写代码——用户只需在配置文件中添加几行 JSON，即可让 AI 获得全新能力。AI Skill Hub 将 Sairo 评为 AI 评分 8.0 分，属于同类工具中的优质选择。

📋 工具概览

Sairo 是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。

GitHub Stars

⭐ 14

开发语言

Python

支持平台

Windows / macOS / Linux

维护状态

轻量级项目，按需更新

开源协议

Apache-2.0

AI 综合评分

8.0 分

工具类型

MCP工具

Forks

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

📌 核心特色

通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
提供结构化工具调用接口，显著降低 AI 集成复杂度
支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
可与其他 MCP 工具组合叠加，构建完整 AI 工作站
轻量无侵入设计，不影响现有系统架构

🎯 主要使用场景

在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
将多个 MCP 工具组合使用，构建个人专属 AI 工作站

以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。

安装命令

# 方式一：通过 Claude Code CLI 一键安装
claude skill install https://github.com/ashwathstephen/sairo

# 方式二：手动配置 claude_desktop_config.json
{
  "mcpServers": {
    "sairo": {
      "command": "npx",
      "args": ["-y", "sairo"]
    }
  }
}

# 配置文件位置
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json

📋 安装步骤说明

确认已安装 Node.js（v18 或以上版本）
打开 Claude Desktop 或 Claude Code 的 MCP 配置文件
按「交给 Agent 安装 → Claude Desktop」标签中的 JSON 配置填入 mcpServers 字段
保存配置文件并重启 Claude 客户端
重启后，在对话中即可使用本工具

以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。

常用命令 / 代码示例

# 安装后在 Claude 对话中直接使用
# 示例：
用户: 请帮我用 Sairo 执行以下任务...
Claude: [自动调用 Sairo MCP 工具处理请求]

# 查看可用工具列表
# 在 Claude 中输入："列出所有可用的 MCP 工具"

以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。

配置示例

// claude_desktop_config.json 配置示例
{
  "mcpServers": {
    "sairo": {
      "command": "npx",
      "args": ["-y", "sairo"],
      "env": {
        // "API_KEY": "your-api-key-here"
      }
    }
  }
}

// 保存后重启 Claude Desktop 生效

📑 README 深度解析真实文档完整度 61/100 查看 GitHub 原文 →

以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

Sairo

A self-hosted, S3-compatible object storage browser. Browse, search, and manage any S3-compatible storage from your browser. Built for petabyte scale.

Works with AWS S3, MinIO, Ceph, Wasabi, Cloudflare R2, Backblaze B2, Leaseweb, NetApp StorageGRID, and any S3-compatible endpoint.

Features

Object Browser — Navigate buckets and prefixes with virtual scrolling for 100K+ objects
Instant Search — SQLite-indexed search across all objects by filename
File Preview — Images, text, CSV, JSON, PDF, Parquet/ORC/Avro schemas, and binary hex
Upload & Download — Multipart upload with progress tracking, drag-and-drop support
Storage Dashboard — Visual breakdown by prefix with growth trend charts and cost estimates
Cost Intelligence — Per-folder cost breakdown with provider comparison. AWS pricing fetched live; others from community data
Version Management — Browse, restore, delete, and purge individual object versions
Version Scanner — Background scan reveals hidden delete markers and ghost objects
Bucket Management — Versioning, lifecycle rules, CORS, ACLs, policies, tagging, object lock
Object Operations — Copy, move, rename, delete (files and folders, bulk)
Share Links — Password-protected share links with configurable expiration
Multi-Endpoint — Connect multiple S3 backends and manage all from one dashboard
Audit Log — Full activity trail with filtering by action, user, and bucket
User Management — Role-based access control (admin / viewer) with per-bucket permissions
Two-Factor Auth — TOTP-based 2FA with QR setup and recovery codes
OAuth & LDAP — Google, GitHub OAuth and LDAP authentication
AI-Powered Analysis (MCP) — Connect Claude, Cursor, or any MCP client to ask natural language questions about your storage. 26 tools for analytics, cost optimization, pipeline health, and more
Petabyte-Scale Performance — Folder listings in 0.05ms on 500K+ objects. Pre-computed prefix hierarchies, 64MB SQLite page cache, 256MB memory-mapped I/O, async FTS rebuilds
Dark Mode — Full dark/light theme with system preference detection
Keyboard Shortcuts — 30+ shortcuts for power users
Single Container — No dependencies. No microservices. Just docker run and go.

Docker

docker run -d --name sairo -p 8000:8000 \
  -e S3_ENDPOINT=https://your-s3-endpoint.com \
  -e S3_ACCESS_KEY=your-access-key \
  -e S3_SECRET_KEY=your-secret-key \
  -e ADMIN_PASS=choose-a-strong-password \
  -e JWT_SECRET=$(openssl rand -hex 32) \
  -v sairo-data:/data \
  stephenjr002/sairo

Then open http://localhost:8000 and log in with admin / your chosen password.

Docker Compose

```bash cp .env.example .env

Uncomment sairo-mcp in docker-compose.yml, then:

docker compose up -d ```

Connect Claude Desktop, Cursor, or any MCP-compatible client and ask:

"What buckets do I have?" — Lists all buckets with sizes and status
"What's eating all the space?" — Storage breakdown by folder with percentages
"How much is this costing me?" — Cost estimates across AWS, R2, B2, Wasabi, Leaseweb
"Find all parquet files" — Full-text search across millions of objects
"Are there any duplicates?" — Finds redundant files with estimated savings
"Is my data pipeline still running?" — Freshness check per folder
"Run a full storage audit" — 7-step analysis with actionable recommendations

26 tools, 4 guided workflows, zero configuration. The AI picks the right tools automatically.

Quick Start

Demo

Sairo Demo

Screenshots


![Dark Mode](docs/screenshots/dark-mode.png)	![Object Browser](docs/screenshots/object-browser-dark.png)
![Search](docs/screenshots/search-dark.png)	![Storage Dashboard](docs/screenshots/storage-dashboard-dark.png)
![File Details](docs/screenshots/file-details-dark.png)	![Bucket List — Light](docs/screenshots/bucket-list.png)

Edit .env with your S3 credentials

docker compose up -d ```

Environment Variables

Variable	Default	Description
`S3_ENDPOINT`	(required)	S3-compatible endpoint URL
`S3_ACCESS_KEY`	(required)	S3 access key
`S3_SECRET_KEY`	(required)	S3 secret key
`S3_REGION`	_(empty)_	S3 region (if required by provider)
`AUTH_MODE`	`local`	Auth mode: `local` (username/password) or `s3` (S3 access key/secret key)
`ADMIN_USER`	`admin`	Default admin username (first run only)
`ADMIN_PASS`	(auto-generated)	Default admin password (first run only)
`JWT_SECRET`	(auto-generated)	Secret for signing JWT tokens. Set for persistent sessions
`SESSION_HOURS`	`24`	Login session duration in hours
`SECURE_COOKIE`	`true`	Set to `false` for HTTP (non-HTTPS) deployments
`RECRAWL_INTERVAL`	`120`	Seconds between automatic re-index cycles
`DB_DIR`	`/data`	Directory for SQLite databases