← 返回目录

HyperChat

社区

非标准 Server

本地 AI Agent 平台，配置即代码，通过 MCP 协议集成工具

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

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

分类: 开发工具第 362 / 438
Stars: ★ 709 非常热门
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: 其他 / 未声明
最近提交: 14 个月前 ⚠

39FMRS · D

HyperChat 是一个本地优先的 AI 聊天与 Agent 平台，围绕「配置即代码」组织 Agent、记忆与 MCP 服务，提供 Web 多工作区与 CLI Agent 优先两套入口。README 内容详实，覆盖环境变量分层、Agent 配置与自定义命令用法，但对 MCP 具体工具清单、传输方式、客户端接入配置均未说明，来源中也没有服务清单（manifest 未缓存）。许可证在来源中标记为 NOASSERTION，README 仅指向 LICENSE 文件，使用前应自行确认授权条款。

最强项 · 文档质量 9/20 最弱项 · 安全与权限 6/20

可靠性

7/20

安全与权限

6/20

维护活跃度

9/20

文档质量

9/20

安装易用性

8/20

查看各项评分依据

可靠性 7/20: README 自称『HyperChat 1.0 完全手工编写、正在迁移到 2.0』，存在版本叙事矛盾，未提供任何可执行的 MCP server 清单（SERVER MANIFEST 为 [not cached]），无法核对工具声明与实际行为、MCP 初始化与 tool-list 握手是否可复现。仓库根目录无被审阅的源码、无提交的测试、README 提到的 build.yml 仅以徽章形式出现而非可验证的测试证据，按静态校准规则可靠性不得高于 12。仅凭 npm 包名与 CLI 命令示例推断存在可运行入口，happy path 尚属可信，但错误处理、依赖可控性、边界情形均无证据，故扣分至 7。
安全与权限 6/20: README 明确将 filesystem、terminal、browser、git、database 等 MCP 工具交给 Agent，且示例中 isConfirmCallTool: false 表示默认不确认即执行工具调用，属于对本地文件系统与终端的危险默认授权，权限最小化与危险操作确认机制不清晰。API 密钥与 Web 密码通过环境变量与 .env 注入，示例使用 sk-1234567890 等占位值，未见真实令牌泄露，也未发现恶意、窃取凭证或隐蔽外传代码。但仓库根目录缺少被审阅的权限校验、路径边界、网络外发声明与数据流披露代码，无法证实沙箱或作用域限制，因此不能给高分，评 6，且不触发 0-4 红线。
维护活跃度 9/20: 仓库未归档，707 stars、30 open issues，README 声明 2.0 正在积极开发并欢迎社区 Vibe Coding，npm 包与 CI 徽章表明存在发布与构建链路，显示一定活跃度。但 LICENSE 为 NOASSERTION，README 仅笼统称『本项目采用开源许可证，详情请查看 LICENSE 文件』而不可核对；未见明确版本策略、治理结构、安全响应渠道或依赖更新证据，issue 响应情况无据。治理与许可证清晰度存在缺口，故评 9 而非更高。
文档质量 9/20: 文档分层较细：双层架构对比表、环境变量 5 层优先级、Agent agent.yaml 与自定义命令 Markdown 模板、多 @ 文件引用示例、Web/CLI 使用场景均给出可读示例，安装与配置说明基本可用。但缺少 MCP server 的 manifest 与工具参数级文档，未披露权限边界、成本/配额、失败排查（troubleshooting）章节缺失，且 README 自身存在 1.0/2.0 能力表述矛盾（如许可证、版本愿景），符合『可用但存在隐藏假设与排查空白』的 10 分锚点附近，评 9。
安装易用性 8/20: 提供 npm install -g @dadigua/hyperchat 或 npx 一键运行，环境变量可通过 export、全局/工作区 .env、CLI 参数五种方式配置，示例清晰，属于少步可落地路径。但未给出任何主流 MCP 客户端（如 Claude Desktop、Cline 等）的配置文件示例，也未说明平台兼容矩阵、Node 运行时版本要求，且仓库根目录未见可核对的包配置以验证 CLI 入口真实存在。按静态校准，无真实 CI 工作流加已提交测试的关键路径证据时 setup 不得高于 15；此处证据更弱，评 8。

静态评测 · 未实际运行收录于 2026-09-10

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络控制浏览器

适合谁

希望 AI 配置完全本地存放并纳入 Git 版本管理的开发者
需要在不同项目间复用个人 Agent 并保留各自上下文的用户
希望通过 MCP 让 Agent 操作本地文件系统等资源的用户
需要命令行与自动化脚本入口的工程团队

不适合谁

只需要一个无需配置的托管式云端聊天服务的用户
要求项目维护方提供官方商业支持或 SLA 的用户
希望直接获得现成 MCP 工具清单与客户端接入配置的用户（README 未提供）

所需权限

本地文件系统读写：README 说明 Agent 可通过 MCP 协议直接操作本地文件系统
读取项目目录下的 .hyperchat/ 配置、Agent 记忆与聊天记录
读取环境变量与 .env 文件（如 API 密钥、服务端口、Web 访问密码）
启动本地 Web 服务并监听端口（默认 16100）
调用外部 LLM 提供商的 API 端点

风险与副作用

Agent 被授予文件系统与终端类 MCP 工具后，可能在未确认的情况下修改本地文件；agent.yaml 中的 isConfirmCallTool 配置会影响是否调用前确认
配置、Agent 记忆与聊天记录以明文文件形式保存在本地目录，若提交到 Git 或共享目录可能泄露敏感信息
API 密钥等凭据存放于环境变量或 .env 文件中，存在误提交或被其他本地进程读取的风险
Web 界面若未设置 HYPERCHAT_WEB_PASSWORD，本地服务可能被同机或同网段访问
自定义命令模板会连同 @ 引用的文件内容一并发送给所配置的 LLM 服务商
README 声明本项目仅供学习交流使用，未描述任何安全保证或审计机制

安装接入

准备工作

运行环境：Node.js

HYPERCHAT_WEB_PASSWORD 可选密钥 Web 界面访问密码，自行设置。

其他可选配置项（6 个）

HYPERCHAT_PORT 可选 Web 服务端口，默认 16100。

HYPERCHAT_HOST 可选服务绑定地址，如 localhost。

HYPERCHAT_LANGUAGE 可选界面语言，支持 zh/en。

HYPERCHAT_LOG_LEVEL 可选日志级别，如 info。

HYPERCHAT_OPENAI_BASE_URL 可选自定义 OpenAI API 端点。

HYPERCHAT_CLAUDE_BASE_URL 可选自定义 Claude API 端点。

README 提供两种方式：1）通过 npm 全局安装：npm install -g @dadigua/hyperchat；或直接运行 npx -y @dadigua/hyperchat。2）从源码开发：git clone https://github.com/BigSweetPotatoStudio/HyperChat.git，进入目录后依次执行 npm install，以及在 packages/electron、packages/web 下执行 npm install，最后运行 npm run dev。使用前需配置环境变量，例如 HyperChat_API_KEY、HyperChat_API_URL、HyperChat_AI_Provider（如 openai/claude/gemini/kimi/qwen）、HyperChat_AI_Model（如 gpt-4o）。可用 hyperchat serve 启动 Web 界面（默认 http://localhost:16100），或用 hyperchat agent <name> "..." 直接调用 Agent。

验证是否装好

全局安装后运行 hyperchat serve 并访问 http://localhost:16100（端口可由 HYPERCHAT_PORT 配置），能看到 Web 多工作区界面且 Agent 可响应对话即说明安装成功。

常见排障

确认已正确设置 HyperChat_API_KEY、HyperChat_API_URL、HyperChat_AI_Provider 与 HyperChat_AI_Model；配置存在 5 层优先级（默认值 < process.env < 全局 .env < 工作区 .env < CLI 参数），可据此排查被覆盖的配置
如果 Web 界面无法访问，检查 HYPERCHAT_PORT（默认 16100）与 HYPERCHAT_HOST 设置，以及是否设置了访问密码
如果 Agent 找不到，先用 hyperchat agent list 查看全局与工作区中可用 Agent
如果 Agent 无法使用某个 MCP 工具，检查 agent.yaml 中的 allowMCPs 是否包含该服务，以及工作区 mcp.json 中的服务池配置
如果自定义命令未生效，确认命令以 .md 文件形式放在 Agent 目录的 commands/ 下，并以 / 前缀调用
需要更多日志时使用 --verbose 或调整 HYPERCHAT_LOG_LEVEL

试试这样问

连接成功后，可以直接对 AI 助手这样说：

分析 @./src/index.ts 的代码质量
对比 @./package. 和 @./yarn.lock 的差异
用 /review 命令审查 @./src/api/user.js 的代码
运行 hyperchat agent coder "/bug-fix @./src/login.ts 登录功能异常"

使用场景

在与项目同目录的 .hyperchat/ 中定义项目专属 Agent、记忆与 MCP 服务池

在 CLI 中以 Agent 优先方式快速发起对话或接入脚本与 CI/CD 流程

在 Web 多工作区界面中同时管理多个项目工作区、Agent 集合与聊天记录

通过 Markdown 模板自定义斜杠命令，复用固定的提示词工作流

用多 @ 文件路径引用一次性分析或对比多个文件

详细介绍

HyperChat 是一个本地 AI Agent 平台（其中文 README 自称「首创 AI as Code 理念」），基于各大 LLM 的 API 提供聊天体验，并通过 MCP 协议实现生产力工具集成。它强调完全本地化：数据不出本地，配置以文件形式存放在 .hyperchat/ 目录中，可随项目迁移并纳入 Git 版本管理。项目采用双层架构：Web 前端提供多工作区标签页协作中心，CLI 前端提供 Agent 优先的快速交互。Agent 支持记忆文件（memory.md）、按 agent.yaml 配置可用的 MCP 服务，以及由 Markdown 模板驱动的自定义命令（如 /bug-fix、/review）。README 说明 HyperChat 1.0 为手工编写项目，正在迁移到 2.0。源代码中未提供 MCP 工具清单、传输方式或客户端接入配置示例。