Iris Agent：开源编码智能体服务，支持 CLI、HTTP API、ACP、LSP 与 MCP

核心能力与快速开始

★ 1 · TypeScript

能做什么

提供流式聊天、工作区工具、LSP 路由、MCP 集成、命令审批和运行生命周期 API。运行形态包括 HTTP 服务（RESTful API 挂载在 /api/agent）、终端交互式 CLI（--chat）以及基于 stdio 的 ACP 服务器（--acp）。支持在聊天请求中传入 workspace、model、history、tools、skills、MCP 与审批设置；提供运行快照读取、持久化事件读取（afterSequence、limit）、运行取消、命令确认、技能列表、工具列表与输入 schema、斜杠命令列表、MCP 工具检查与调用等端点。ACP 侧支持会话加载与列表，并可返回每会话模型配置项。文件、聊天会话、语义搜索与 LSP 路由面向 AIRIS 桌面客户端。

适用场景

作为独立编码智能体服务供 IDE 集成（如通过 ACP 接入 VS Code ACP Client）或后端进程调用；通过 CLI 在终端中进行交互式流式编码对话；通过 HTTP API 供桌面客户端或浏览器客户端发起聊天、查看运行生命周期事件与取消运行；通过 MCP 接入本地 stdio 或远程 Streamable HTTP 的 MCP 服务器并调用其工具；在受控环境内使用命令审批机制批准或跳过待执行命令。

项目形态

可直接使用的工具

部署方式

可作为 HTTP 服务运行，默认监听 8080 端口（PORT 可配置），API 挂载于 /api/agent；也可作为 CLI 或 stdout 上的 ACP 服务器运行。HTTP 服务通过 dotenv/config 支持本地 .env 文件。桌面专用路由需要同时设置 TAURI_BUNDLED=1 与 IRIS_DESKTOP_TOKEN。可选通过 Homebrew tap（macOS/Linux）安装 CLI。浏览器跨域调用需配置 AGENT_ALLOWED_ORIGINS。

主要依赖

SDK 与 ACP 服务器要求 Node.js >=22.13.0。需配置所选模型提供商的 API Key（如 OPENROUTER_API_KEY、OPENAI_API_KEY、ANTHROPIC_API_KEY、GOOGLE_GENERATIVE_AI_API_KEY、OLLAMA_API_KEY、HF_TOKEN）；本地 ollama/<model> 会话无需云 API Key。IrisClient 面向 Node.js（IDE 桌面或后端进程），不适用于浏览器渲染进程。浏览器网页搜索依赖 puppeteer，会下载兼容的 Chrome。

使用限制

remote MCP 仅支持 Streamable HTTP 传输，不支持旧版 SSE 传输。MCP 配置中 command 与 url 只能二选一，若同时提供则 url 优先且 command 被丢弃；url 存在但格式不受支持时会整体拒绝该配置。MCP 工具名以 mcp_<server name>_<tool name> 生成且必须以 mcp_ 开头。单个 ACP 进程绑定启动时指定的工作区，切换工作区需关闭并重新启动进程。工具结果超过 16 KiB 或无法 JSON 序列化时以有界摘要替换。模型 API 与第三方 MCP 服务的费用及限制未说明。

许可证

MIT

最近推送

2026-09-23 06:51

资料检查：2026-09-23 07:00 · 卡片整理：2026-09-23 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容