← 返回目录

OpenPaean

社区

非标准 Server

开源 AI 代理命令行工具，集成全屏终端界面与本地 MCP 服务器。

这不是典型的可直接连接的 MCP Server，使用前请先阅读源仓库说明。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 308 / 438
Stars: ★ 94 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+ · Bun
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 6 个月前 ⚠

45FMRS · D

OpenPaean 是一个新兴的开源 AI 代理 CLI，提供全屏 TUI 和本地 MCP 集成。它适合终端用户和需要本地工具调用的场景。

最强项 · 维护活跃度 11/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

10/20

维护活跃度

11/20

文档质量

10/20

安装易用性

9/20

查看各项评分依据

可靠性 5/20: 仓库根目录缺少明确的服务器清单和测试文件。项目是一个CLI工具，而非传统的MCP服务器，其MCP客户端功能依赖外部API，但API细节未在仓库中体现。启动流程和工具列表握手未提供直接证据，错误处理和依赖控制仅由README中的选项暗示。尽管可能可行，但缺乏可复现的测试或CI来验证关键路径，且不确定其作为MCP服务器是否完全正常。
安全与权限 10/20: 未发现明显红线：无恶意代码迹象，无硬编码凭据，凭据存储在本地配置目录。提供了安全策略和可信MCP服务器警告。但权限最小化、数据流披露和危险操作确认等细节不完整。未暴露网络调用或远程命令默认执行，因此评为中等偏上。
维护活跃度 11/20: 仓库有95星，6个未解决问题，未归档。有MIT许可证，README中提到了安全策略和贡献指南。但未提供版本发布、提交频率或依赖更新的直接证据，治理细节不全面。
文档质量 10/20: README提供了安装、登录、启动和配置MCP服务器的说明，并包含选项和环境变量。有架构图，但缺少工具参数细节、API限流、成本或故障排除的具体信息。文档部分覆盖了使用场景，但深度有限。
安装易用性 9/20: 安装步骤清晰，提供curl脚本、bun、npm和npx多种方式。创建MCP配置文件有示例，但对客户端配置的示例不足。需要Node.js 18+或Bun，且依赖Paean AI账户。整体易用，但手动步骤较多。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络

适合谁

喜欢在终端中工作的开发者
需要本地工具集成的 AI 代理用户

不适合谁

需要图形界面的用户
不使用 Node.js 或 Bun 环境的人

所需权限

访问本地文件系统（通过 MCP 服务器）
读取和写入用户配置目录（~/.openpaean/）

风险与副作用

配置不受信任的 MCP 服务器可能导致任意代码执行
凭据存储在本地，需保护配置文件

安装接入

准备工作

运行环境：Node.js 18+ · Bun

其他可选配置项（2 个）

OPENPAEAN_API_URL 可选覆盖默认 API 端点，用于自托管后端；仅在使用自托管部署时需要设置。

OPENPAEAN_WEB_URL 可选覆盖 Web 端 URL，用于 OAuth 回调；仅在使用自托管部署时需要设置。

快速安装：运行 curl -fsSL https://paean.ai/openpaean/install.sh | bash，或者使用包管理器全局安装：bun add -g openpaean 或 npm install -g openpaean，还可以直接使用 npx openpaean。

验证是否装好

运行 `openpaean login` 完成认证后启动 `openpaean`，若全屏 TUI 正常打开并显示流式 AI 回复，即说明安装成功。

常见排障

确保 Node.js 18+ 或 Bun 已安装
检查网络连接是否正常
确认 MCP 服务器配置正确且可访问

使用场景

在终端中进行交互式 AI 对话

通过本地 MCP 服务器调用工具

从命令行查看、创建和管理任务

详细介绍

OpenPaean 是一个功能强大的命令行 AI 代理，提供全屏终端用户界面、交互式智能体聊天、任务管理，并支持连接本地 MCP 服务器以调用工具。