你是否想过,让大语言模型(LLM)像打开一个文件夹那样轻松读取数据库、调用API、执行Python脚本,甚至实时抓取网页内容?Mirage正是为此而生——它不是又一个提示词工程库,而是一个为AI智能体量身定制的统一虚拟文件系统(Virtual Filesystem)。它把分散的工具、服务和数据源,全部映射成标准的文件路径(如/api/weather?city=shanghai或/db/users.csv),让任何支持文件I/O的AI Agent(无论用LangChain、LlamaIndex还是自研框架)都能用最自然的read()、write()、ls()指令完成复杂任务。
核心功能
- 统一抽象层:将HTTP API、数据库查询、Python函数、Bash命令、云存储(S3/MinIO)、甚至实时Web内容,全部封装为可挂载的虚拟目录与文件,屏蔽底层差异
- 跨语言原生支持:提供开箱即用的Python包(
pip install mirage-ai)和TypeScript SDK,无缝集成主流AI开发栈 - FUSE内核级挂载(可选):在Linux/macOS上通过FUSE将虚拟文件系统挂载为真实目录(如
/mnt/mirage),让cat /mnt/mirage/api/github/repos成为可能 - 沙箱化安全执行:所有外部调用默认运行在隔离沙箱中,自动限制超时、资源用量与网络访问范围,防止Agent“越界”执行危险操作
- 可插拔驱动生态:内置对OpenAI/Claude/Anthropic等主流LLM的适配器,同时支持自定义驱动——你想接入飞书多维表格、微信公众号接口或私有ERP系统?写一个驱动即可
- 开发者友好调试体验:提供CLI命令行工具(
mirage ls /tools)、可视化Web控制台(mirage serve)及完整日志追踪,让Agent行为“看得见、摸得着”
适合哪些人用
如果你是以下角色之一,Mirage值得立刻加入你的AI工程工具箱:
• AI应用开发者:正在构建自动化客服、智能数据分析助手或RAG工作流,苦于工具链杂乱、协议不一;
• 大模型研究员:需要快速验证Agent在真实工具环境中的推理能力,而非仅限于模拟环境;
• 企业IT架构师:希望为内部LLM平台提供标准化、可审计、易管控的工具接入方案;
• 教育者与学生:用直观的“文件操作”概念降低AI Agent学习门槛,让初学者也能亲手搭建能上网、能查库、能写代码的智能体。
快速上手
只需两步,5分钟体验Mirage威力:
- 安装:
Python用户执行:pip install mirage-ai;
TypeScript用户执行:npm install @strukto/mirage - 启动一个示例Agent:
在Python中导入后,几行代码即可创建带GitHub、天气、计算器能力的虚拟文件系统:from mirage import Mirage
fs = Mirage().mount("github", "weather", "calculator")
print(fs.read("/github/user/strukto-ai"))
更详细的入门指南请查阅Python快速开始或TypeScript快速开始文档。
项目信息
strukto-ai/mirage
GitHub
A Unified Virtual Filesystem For AI Agents
1.5k
Stars
86
Forks
TypeScript
Apache-2.0
编程语言:TypeScript(主仓库),同时提供高质量Python绑定
GitHub Star 数:1460(持续增长中)
开源协议:Apache-2.0
项目地址:https://github.com/strukto-ai/mirage
如果你厌倦了为每个新工具写一堆适配胶水代码,Mirage就是那个让你的AI智能体真正“活起来”的操作系统级基础设施。



