Apache-2.0 の AI エージェント向け統合仮想ファイルシステム。約 50 のサービスを bash 互換の 1 ツリーにマウントし、ネイティブアダプター・プラグイン・MCP・FUSE 経由で DeepSeek Harness に接続できる。
DSH 統合
互換
作者による申告
安全性監査
未監査
最終検証日
2026-08-21
ライセンス
Apache-2.0
01どんなタスクに使えるのか？
Give DeepSeek Harness bash-level access to S3, Google Drive, Slack, Gmail, Redis and ~50 more services as one virtual filesystem
A single mounted workspace where read, grep and pipe commands sweep every backend out of the box, with zero new vocabulary
Developers running DeepSeek Harness (dsh) who want their agent to query real cloud and SaaS data without wiring up separate SDKs or MCP servers
Compose cross-service pipelines and keep agent runs portable on DeepSeek Harness
bash pipelines that span backends (e.g. run a script stored in Slack and file the report into Redis), plus clone / snapshot / version of portable workspaces that move between machines
Teams building agent workflows on DeepSeek Harness that need reproducible, portable workspaces across services
02DeepSeek Harness への導入方法
前提条件
- Python ≥ 3.11 for the `mirage-ai` package and the `mirage` CLI
- Node.js ≥ 20 for the TypeScript SDK
- macOS or Linux (FUSE-based mounts require platform support)
インストール手順
- 01
Python: run `uv add mirage-ai` — installs the `mirage` library and the `mirage` CLI binary
- 02
TypeScript: run `npm install @struktoai/mirage-node` (Node.js servers and CLIs), `npm install @struktoai/mirage-browser` (browser / edge runtimes), and optionally `npm install @struktoai/mirage-agents` (OpenAI / Vercel AI / LangChain / Mastra adapters)
$ npm install @struktoai/mirage-node
- 03
CLI: run `curl -fsSL https://strukto.ai/mirage/install.sh | sh`, or `npm install -g @struktoai/mirage-cli`, or `uvx mirage-ai`, or `npx @struktoai/mirage-cli`
$ curl -fsSL https://strukto.ai/mirage/install.sh | sh
導入成功の確認
作者は未記載
03DSH 統合と能力の範囲
Used inside DeepSeek Harness as a coding-agent tool layer via native adapter, installable plugin, MCP, or FUSE mount
Unified virtual filesystem with ~50 built-in backends
S3 / R2 / GCS / Supabase, Gmail / GDrive / GDocs / GSheets / GSlides, GitHub / Linear / Notion / Trello, Slack / Discord / Email, MongoDB / Postgres / LanceDB / Qdrant, Redis, SSH, RAM, Disk→one filesystem tree under a single root, readable with standard bash semantics (read, grep, pipe)
reads and writes are executed against the mounted remote services using your own credentials/tokensPortable workspaces (clone / snapshot / version)
a configured Mirage workspace→snapshot archives (e.g. demo.tar) that can be loaded on another machine to restore the workspace
snapshot files are written to diskTwo-layer cache for remote backends
repeated reads against remote backends→index cache (listings/metadata, default TTL 10 minutes) and file cache (object bytes, default 512 MB) served from local state
cache state is held in-process RAM by default; an optional Redis store shares cache state across workers, processes, and machinesEmbeddable Python and TypeScript SDKs
a Python ≥ 3.11 or Node.js ≥ 20 application→workspaces running in-process inside FastAPI, Express, browser apps, or any async runtime — no separate process required
04誰に向いているのか？使うべきでない場面は？
向いている用途
- Developers running DeepSeek Harness (dsh) who want their agent to query real cloud and SaaS data without wiring up separate SDKs or MCP servers
- Teams building agent workflows on DeepSeek Harness that need reproducible, portable workspaces across services
不向きな用途
- Mirage targets macOS or Linux; FUSE-based mounts additionally require platform support, so FUSE mounting is not guaranteed on every machine.
- Mounted remote backends (Slack, S3, Gmail, Redis, ...) are reached over the network with your own credentials — e.g. a Slack bot token is passed in the resource config — so writes can mutate the underlying services.
05互換性・メンテナンス・セキュリティ上の注意
- Mirage targets macOS or Linux; FUSE-based mounts additionally require platform support, so FUSE mounting is not guaranteed on every machine.
- The Python SDK and CLI require Python ≥ 3.11, and the TypeScript SDK requires Node.js ≥ 20 — older runtimes cannot run Mirage.
- Mounted remote backends (Slack, S3, Gmail, Redis, ...) are reached over the network with your own credentials — e.g. a Slack bot token is passed in the resource config — so writes can mutate the underlying services.
Apache-2.0 · actively maintained (latest release v0.0.5, 2026-08-15)
06よくある質問
Mirage は DeepSeek Harness にどう接続しますか？
DeepSeek Harness は Mirage 公式のコーディングエージェント統合一覧に記載されています。ネイティブアダプター、インストール可能なプラグイン、MCP、FUSE マウントのいずれかで接続でき、Mirage ドキュメントには DeepSeek Harness 専用のクイックスタート（docs.mirage.strukto.ai/typescript/agents/dsh）も用意されています。
ネイティブ統合ですか、それとも MCP ですか？
両方の経路があります。ネイティブアダプターとインストール可能なプラグイン、または MCP と FUSE のいずれでも接続可能なので、DeepSeek Harness でのワークフローに合わせて選べます。
インストールに必要な前提条件は？
`mirage-ai` パッケージと `mirage` CLI には Python ≥ 3.11、TypeScript SDK には Node.js ≥ 20 が必要です。FUSE ベースのマウントを使う場合は macOS または Linux で、かつプラットフォームが FUSE に対応している必要があります。
どのサービスをマウントできますか？
約 50 の組み込みバックエンドに対応：RAM、Disk、Redis、S3 / R2 / OCI / Supabase / GCS、Gmail / GDrive / GDocs / GSheets / GSlides、GitHub / Linear / Notion / Trello、Slack / Discord / Email、MongoDB / GridFS / Postgres / LanceDB / Qdrant、SSH などがすべて 1 つのルート配下に並列マウントされます。
読み書きしたデータはどこへ行きますか？
コマンドはマウントされたバックエンドに対して直接実行されます。リモートサービスへはネットワーク経由で、Slack の bot トークンなど自身の認証情報を使ってアクセスします。2 層キャッシュ（インデックス＋ファイル、既定ではプロセス内 RAM、任意で Redis）により、繰り返しの読み取りはローカルから提供されます。
07関連する DSH ワークフロー
weknora
by tencent
オープンソースのLLMナレッジプラットフォーム。生ドキュメントを検索可能なRAG、自律推論エージェント、自己更新型Wikiへ変換する。
honcho
by plastic-labs
ステートフルなエージェントを構築するためのメモリライブラリ。会話履歴や状態を管理し、長期的な文脈保持を実現します。
reme
by agentscope-ai
エージェント向けのメモリ管理キット。「Remember Me, Refine Me」――記憶の保持と改善を支援します。
memsearch
by zilliztech
Markdown と Milvus を基盤とした、AI エージェント向けの永続的・統合メモリレイヤー。
08データと出典
**Agent integrations:** OpenAI Agents SDK, Vercel AI SDK, LangChain, Pydantic AI, CAMEL, and OpenHands via the SDKs; cod…
| Coding agents | [Claude Code](https://docs.mirage.strukto.ai/python/agents/claude-code), [Codex](https://docs.mirage.s…
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日：2026-08-21。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。