nanbingxyz/5ire · 上手攻略
- 仓库：nanbingxyz/5ire
- 链接：https://github.com/nanbingxyz/5ire
- 分类：ai · desktop-app · mcp-client
- 作者：Tom
- 更新：2026-07-15
这是什么
5ire（读作 "fire-er"）是一个跨平台桌面 AI 助手，同时也是一个功能完整的 MCP（Model Context Protocol）客户端。它内置对 OpenAI、Azure OpenAI、Anthropic、Google、Mistral、豆包、Grok、DeepSeek、Ollama 等主流 AI 提供商的支持，并允许用户通过 MCP 协议接入各种工具（文件系统、数据库、网络搜索等），将本地知识库和远程工具统一纳入 AI 对话上下文。
一句话类比：5ire = AI 对话客户端 + MCP 工具调用中枢 + 本地知识库 RAG。
解决什么问题
- 多 AI 提供商管理：不需要在多个客户端之间切换，5ire 一个界面覆盖所有主流模型
- MCP 工具扩展：让 AI 能够调用本地工具（读文件、执行命令、查数据库），而不只是聊天
- 本地知识库：上传文档（docx/xlsx/pdf/pptx/txt/csv）自动向量化，构建私有 RAG
- API 消费追踪：记录每个 provider 的 API 消耗和费用，帮助成本控制
- Prompt 库管理：变量驱动的可复用 Prompt 模板
快速安装
前置依赖
5ire 由 Python + Node.js 构建，需要以下运行时（不论是否使用工具功能）：
| 依赖 | 最低版本 | 安装方式 |
|---|---|---|
| Python | 3.x | python.org，记得勾选 Add Python to PATH |
| Node.js | LTS | nodejs.org，或 brew install node / scoop install nodejs-lts |
| uv | 最新 | curl -LsSf https://astral.sh/uv/install.sh | sh（macOS/Linux）或 pip install uv |
⚠️ macOS 构建需要配置 APPLE_TEAM_ID、APPLE_ID、APPLE_ID_PASS 以完成代码签名和公证，避免安全警告弹出。
下载与运行
前往 Releases 页面 下载对应平台的构建包（.dmg / .AppImage / .exe），或从源码构建：
git clone https://github.com/nanbingxyz/5ire.git
cd 5ire
# 参考 INSTALLATION.md 完成依赖安装后启动
详细安装步骤见官方 INSTALLATION.md。
核心用法
1. 配置 AI 提供商
首次启动后在设置面板添加 API Key，支持以下 provider：
- OpenAI（GPT 系列）
- Azure OpenAI
- Anthropic（Claude 系列）
- Google（Gemini 系列）
- Mistral
- 豆包（ByteDance）
- Grok
- DeepSeek
- Ollama（本地模型）
⚠️ API Key 存储在本地，不上传云端，但建议了解桌面应用的常规安全风险。
2. MCP 工具调用
MCP 是 AI 应用的「USB-C 接口」标准，让 AI 能调用各种工具而不用每种工具单独集成。
5ire 内置了 MCP Server 市场，支持一键安装各类工具服务。配置好 MCP Server 后，在对话中就可以让 AI 执行：
- 读/写本地文件
- 执行 shell 命令
- 查询数据库
- 访问远程 API
5ire 的 MCP Server 市场 提供社区维护的工具列表，可按需发现和安装。
3. 本地知识库（RAG）
上传文档后，5ire 使用 bge-m3 本地 embedding 模型将文档分块向量化存入向量数据库。
支持格式：docx、xlsx、pptx、pdf、txt、csv
在对话中，AI 会自动检索知识库相关内容注入上下文，实现「问私有文档」的能力。
4. Prompt 模板库
内置 Prompt 库支持变量插值（{{variable}}），可创建可复用的 Prompt 模板，在不同对话场景中切换。
5. 对话书签与搜索
每个对话可以加书签，书签内容不受原对话删除影响；支持全对话历史全文搜索。
典型适用场景
- 开发者日常 AI 助手：同时用 Claude 写代码、GPT 写文案、DeepSeek 跑推理，切换 provider 不切换窗口
- 私有知识问答：上传内部文档，用 AI 问答而不把数据发给第三方
- MCP 工具链构建：用 5ire 作为 MCP 生态的桌面入口，探索各种 AI 工具组合
- API 费用管控：多人共用账号时追踪各 provider 消费明细
- 离线 Ollama 场景：在 5ire 里接本地 Ollama，跑完全本地的大模型
坑与注意
- 非 Web 应用：5ire 是桌面应用（Tauri/Electron 类），不是浏览器插件，需要下载安装包
- Python/Node.js 依赖：即使不写工具，也需要这两个运行时，后端 MCP Server 需要 Python
- MCP Server 配置有门槛：理解 MCP 协议和工具注册流程对新手有一定学习成本
- 本地 embedding 模型：bge-m3 模型文件不小（约 1-2GB），首次使用需要下载
- 代码签名（macOS）：不配置 Apple ID 证书的话，安装后运行会弹安全警告，需手动绕过（系统偏好设置 → 安全与隐私）
- 文档较少：项目相对新，Wiki 和示例覆盖还不够完整，遇到问题主要靠 Discord 社区
- Ollama 版本要求：接 Ollama 时建议使用较新版本，旧版 API 兼容性问题较多
与同类对比
| 特性 | 5ire | Cherry Studio | Open WebUI | AnythingLLM |
|---|---|---|---|---|
| 多 provider 切换 | ✅ 9+ 种 | ✅ | ✅ | ✅ Ollama 为主 |
| MCP 协议 | ✅ | ❌ | ❌ | ❌ |
| 本地知识库 | ✅ bge-m3 | ✅ | ✅ | ✅ |
| API 费用追踪 | ✅ | 部分 | ❌ | ❌ |
| Prompt 模板库 | ✅ | ✅ | 部分 | 部分 |
| 跨平台桌面 | ✅ Mac/Win/Linux | ✅ | 仅 Web | ✅ |
| 开源免费 | ✅ | ✅ | ✅ | ✅ |
5ire 的独特优势是 MCP 原生支持，这是大多数同类产品没有覆盖的功能。如果你想要的不只是对话客户端，而是「AI + 工具 + 知识库」的一体化桌面入口，5ire 是目前难得的合一把手。
一句话推荐结论
如果你想要一个同时管理多个 AI 提供商、能调用 MCP 工具、并支持本地知识库的桌面 AI 客户端，5ire 是这个赛道里 MCP 支持最完整、功能整合度最高的选择——尤其适合开发者搭建本地 AI 工作流。
注意：本文基于 GitHub README 和 INSTALLATION.md 整理。项目发布频率较高，安装前建议查看 Releases 页面核实最新版本号。MCP Server 市场（mcpsvr）内容由社区维护，安装第三方工具前请自行评估安全性。