经 AI Skill Hub 精选评估，HyperChat MCP工具 获评「推荐使用」。这款MCP工具在功能完整性、社区活跃度和易用性方面表现出色，AI 评分 7.8 分，适合有一定技术背景的用户使用。
HyperChat MCP工具 是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。
HyperChat MCP工具 是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。
# 方式一：通过 Claude Code CLI 一键安装
claude skill install https://github.com/BigSweetPotatoStudio/HyperChat
# 方式二：手动配置 claude_desktop_config.json
{
"mcpServers": {
"hyperchat-mcp--": {
"command": "npx",
"args": ["-y", "hyperchat"]
}
}
}
# 配置文件位置
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json
# 安装后在 Claude 对话中直接使用 # 示例： 用户: 请帮我用 HyperChat MCP工具 执行以下任务... Claude: [自动调用 HyperChat MCP工具 MCP 工具处理请求] # 查看可用工具列表 # 在 Claude 中输入："列出所有可用的 MCP 工具"
// claude_desktop_config.json 配置示例
{
"mcpServers": {
"hyperchat_mcp__": {
"command": "npx",
"args": ["-y", "hyperchat"],
"env": {
// "API_KEY": "your-api-key-here"
}
}
}
}
// 保存后重启 Claude Desktop 生效
hyperchat "分析 @./src/index.ts 的代码质量" hyperchat "对比 @./package.json 和 @./yarn.lock" hyperchat "请比较 @./src/components/ 和 @./docs/ 的结构"
hyperchat agent coder "/bug-fix @./src/login.ts 登录功能异常" hyperchat agent coder "/review @./src/api/user.js" hyperchat agent coder "/optimize 这段代码性能不好"
npm install cd packages/electron && npm install cd packages/web && npm install cd ../..
npm install -g @dadigua/hyperchat
hyperchat agent create personal-coder --template ~/ai-templates/
```bash
npx -y @dadigua/hyperchat
**快速配置环境变量**：hyperchat "你好，世界！" # 使用配置的默认模型 ```
```bash
hyperchat serve # 访问: http://localhost:16100
```bash
hyperchat agent list # 发现可用 Agent（全局 + 工作区） hyperchat agent mybot "你好" # 🎯 直接启动 Agent，按需加载 MCP hyperchat agent mybot chat # 🎯 Agent 专属对话会话
hyperchat "你好，今天怎么样？" # 直接与默认模型聊天 hyperchat chat "写一个 Python 脚本" # 聊天命令 hyperchat chat # 交互式聊天模式
hyperchat agent test-runner "运行所有测试并生成报告"
cd /project-a && hyperchat agent personal-coder "分析这个项目" cd /project-b && hyperchat agent personal-coder "分析这个项目"
allowMCPs: ["filesystem", "git", "npm", "database"] prompt: | 你是本项目的专属 AI 助手，熟悉： - 项目架构：React + TypeScript + Node.js - 业务领域：电商平台开发 - 团队规范：ESLint + Prettier + Jest 请基于项目上下文提供专业建议。 tags: ["project", "fullstack", "ecommerce"]
#### Agent 自定义命令目录结构 ✨**新功能**
#### 命令模板示例（纯Markdown）hyperchat agent project-assistant "/bug-fix @./src/login.ts 用户登录后跳转异常"
hyperchat agent project-assistant "/review @./src/components/UserProfile.tsx"
hyperchat agent project-assistant chat > /bug-fix 这个函数有内存泄漏问题 > /optimize @./src/utils/dataProcessor.js
npm run dev
export HyperChat_API_KEY=your-api-key # API 密钥 export HyperChat_API_URL=your-api-url # API 端点 URL export HyperChat_AI_Provider=openai # AI 提供商 (openai/claude/gemini/kimi/qwen等) export HyperChat_AI_Model=gpt-4o # 默认模型名称
hyperchat chat --workspace /path/to/project # 使用特定工作区 hyperchat --verbose chat "你好" # 详细日志 hyperchat --help # 显示帮助
```
HyperChat 2.0 实现了强大的5层优先级环境变量系统，让配置管理更加灵活：
优先级顺序（从低到高）： 1. 默认值 - 代码中的内置默认配置 2. process.env - 系统环境变量 3. 全局 .env - ~/Documents/HyperChat/.env 4. 工作区 .env - 项目目录下的 .env 文件 5. CLI 参数 - 命令行传入的参数（最高优先级）
支持的核心环境变量： ```bash
HyperChat_API_KEY=your-api-key # 默认 API 密钥 HyperChat_API_URL=your-api-url # 默认 API 端点 HyperChat_AI_Provider=openai # 默认 AI 提供商 HyperChat_AI_Model=gpt-4o # 默认模型名称
HYPERCHAT_WEB_PASSWORD=your-web-password # Web 界面访问密码 HYPERCHAT_PORT=16100 # Web 服务端口 HYPERCHAT_HOST=localhost # 服务绑定地址
HYPERCHAT_LANGUAGE=zh # 界面语言 (zh/en) HYPERCHAT_LOG_LEVEL=info # 日志级别
export HyperChat_API_KEY=sk-1234567890 export HyperChat_AI_Provider=openai export HyperChat_AI_Model=gpt-4o hyperchat "你好" # 直接使用默认配置
export HYPERCHAT_WEB_PASSWORD=mypassword hyperchat serve
echo "HyperChat_API_KEY=your-key" > .env echo "HyperChat_AI_Provider=claude" >> .env hyperchat chat
hyperchat serve --password=clipass
echo "HyperChat_API_KEY=global-key" > ~/Documents/HyperChat/.env echo "HyperChat_AI_Provider=gemini" >> ~/Documents/HyperChat/.env ```
🌐 Web 多工作区模式配置：
项目目录/
├── .hyperchat/ # 工作区统一配置目录
│ ├── mcp.json # 🔌 工作区级 MCP 服务池
│ ├── ai_models.json # 🤖 工作区 AI 模型配置
│ ├── .env # 工作区环境变量
│ └── agents/ # 🗂️ 工作区 Agent 集合
│ ├── project-assistant/ # 项目专用 Agent
│ │ ├── agent.yaml # Agent 配置
│ │ ├── memory.md # 项目上下文记忆
│ │ └── chatlogs/ # 团队对话历史
│ └── code-reviewer/ # 代码审查 Agent
├── .git/ # 版本控制
└── package.json # 项目配置
💻 CLI Agent 优先模式访问：
全局配置/
~/Documents/HyperChat/
.hyperchat/
├── mcp.json # 🌍 全局 MCP 服务池
├── .env # 全局环境变量
└── agents/ # 🚀 全局 Agent 库
├── personal-assistant/ # 个人助手 Agent
│ ├── agent.yaml # Agent 配置
│ ├── memory.md # 个人上下文记忆
│ └── chatlogs/ # 个人对话历史
└── code-expert/ # 专业代码 Agent双层配置的核心优势： - 🌐 Web 模式：工作区中心化，适合项目级管理和团队协作 - 💻 CLI 模式：Agent 中心化，支持跨项目的个人工具使用 - 🔄 智能合并：全局配置 + 工作区配置的 5 层优先级管理 - 💾 数据隔离：项目级和个人级数据完全分离，互不干扰
```
git add .hyperchat/agents/project-assistant/ git commit -m "添加项目专用 AI 助手" git push origin feature/project-ai
git checkout HEAD~1 -- .hyperchat/
#### 💻 CLI 模式：个人工具管理#### Agent 基础配置 ```yaml
设计理念：Agent 中心化，极速启动单个智能体
HYPERCHAT_OPENAI_BASE_URL=https://api.openai.com/v1 HYPERCHAT_CLAUDE_BASE_URL=https://api.anthropic.com
**使用示例**：```
| 模型提供商 | 推荐程度 | 特色功能 |
|---|---|---|
| Claude | ⭐⭐⭐⭐⭐⭐ | 最强 |
| Kimi k2 | ⭐⭐⭐⭐⭐ | 很不错 |
| 功能特性 | 🌐 Web 多工作区模式 | 💻 CLI Agent 优先模式 |
|---|---|---|
| **核心理念** | ||
| 设计中心 | 🗂️ 工作区协作中心 | 🤖 Agent 直接交互 |
| 资源管理 | 工作区统一 MCP 池 | Agent按需启动MCP |
| 使用方式 | 多标签页并发管理 | 单 Agent 快速启动 |
| **界面体验** | ||
| 界面风格 | 🖥️ 现代 Web 界面 | 📟 命令行 + 🎨 TUI |
| 交互模式 | 鼠标点击 + 表单操作 | 键盘输入 + 命令参数 |
| 实时更新 | ✅ SSE 流式推送 | ✅ 终端流式输出 |
| **适用场景** | ||
| 主要用途 | 项目开发、团队协作 | 快速对话、脚本集成 |
| 使用环境 | 桌面浏览器、开发 IDE | 终端、服务器、CI/CD |
| 工作流程 | 长期项目管理 | 临时对话处理 |
HyperChat 是一款专为开发者设计的智能交互工具，旨在通过强大的 AI 能力提升开发效率。它不仅提供直观的 Web 界面，还深度集成了命令行交互能力，支持通过 Agent 模式快速调用 AI 能力，是连接本地代码库与大语言模型的桥梁。
HyperChat 提供了极具创新性的 Web 界面功能。新增的智能文件处理支持通过 @ 符号直接引用本地文件（如 @./src/index.ts），实现精准的代码分析与对比。此外，通过 Agent 自定义命令功能，开发者可以利用预设的专业提示词（如 /bug-fix, /review, /optimize）快速启动特定的开发任务，实现高效的自动化工作流。
在开始使用 HyperChat 之前，请确保您的开发环境已安装 Node.js 及 npm 包管理器。由于项目采用 Monorepo 架构，安装时需要进入各个 packages 目录分别执行 npm install，以确保 electron 和 web 端依赖完整加载。
您可以通过 npm 全局安装 HyperChat：执行 `npm install -g @dadigua/hyperchat` 即可快速完成部署。此外，项目也支持通过源码编译安装，或利用 `hyperchat agent create` 命令基于自定义模板快速部署属于您个人的专属 Agent。
HyperChat 支持多种启动方式。您可以通过命令行直接运行 `hyperchat` 进行交互，或者使用 `npx -y @dadigua/hyperchat` 免安装运行。在首次使用前，请务必配置好环境变量以确保模型连接正常。通过命令行，您可以直接向 AI 发起对话，体验极速的交互响应。
用户可以通过设置环境变量来灵活配置 HyperChat 的运行参数。您可以自定义 HyperChat_API_KEY、HyperChat_API_URL 以及指定的 AI_Provider（如 openai, claude, gemini, kimi, qwen 等）和默认模型名称。同时，支持通过 --workspace 参数指定特定的工作区，实现不同项目的上下文隔离。
HyperChat 的 CLI 设计遵循 Agent 优先原则，专为极速交互而生。它支持从工作区按需加载 MCP 工具，并为每个 Agent 提供专属的记忆、上下文和聊天历史。这种设计使其不仅适用于日常对话，还能完美融入自动化脚本、命令行工作流以及 CI/CD 集成场景中。
HyperChat 具备极强的脚本集成与自动化潜力。通过灵活的 Agent 机制与 MCP 工具链，开发者可以将 AI 能力无缝嵌入到现有的开发工作流中。同时，我们提供了 AI 模型推荐表，针对不同需求（如使用 Claude 进行最强推理或使用 Kimi 进行特定任务）提供决策参考。
MCP生态实用工具，TypeScript实现质量可靠。710星说明社区认可度不错，适合开发者集成定制。活跃维护增加可信度。
该工具使用 NOASSERTION 协议，商用场景请仔细阅读协议条款，必要时咨询法律意见。
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
📄 NOASSERTION — 请查阅原始协议条款了解具体使用限制。
AI Skill Hub 点评：HyperChat MCP工具 的核心功能完整，质量良好。对于Claude Desktop / Claude Code 用户来说，这是一个值得纳入个人工具库的选择。建议先在非生产环境试用，再逐步推广。
| 原始名称 | HyperChat |
| 原始描述 | 开源MCP工具：HyperChat is a Chat client that strives for openness, utilizing APIs from variou。⭐710 · TypeScript |
| Topics | 聊天客户端MCP协议本地agent多LLM支持开源 |
| GitHub | https://github.com/BigSweetPotatoStudio/HyperChat |
| License | NOASSERTION |
| 语言 | TypeScript |
收录时间：2026-05-14 · 更新时间：2026-05-16 · License：NOASSERTION · AI Skill Hub 不对第三方内容的准确性作法律背书。
选择 Agent 类型，复制安装指令后粘贴到对应客户端