← 返回目录

Neo Chat

社区

非标准 Server

本地优先的 AI 聊天工作区，支持模型、代理、技能、插件、搜索、RAG、语音、记忆和工件。

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

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

分类: 其他第 88 / 230
Stars: ★ 1.9k 非常热门
运行环境: Node.js 22+ · Docker
凭据: 可选 API Key
许可证: MIT
最近提交: 5 天前

58FMRS · C

Neo Chat 是一款功能丰富的本地优先 AI 聊天应用，强调数据所有权和自托管。它提供多提供商集成、技能、插件、RAG、搜索、语音和同步等功能，适合技术用户。然而，它并非开箱即用的公开 SaaS，需要安全部署和配置。

最强项 · 文档质量 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

14/20

文档质量

14/20

安装易用性

10/20

查看各项评分依据

可靠性 8/20: 源代码显示这是一个大型Next.js应用，有广泛的测试（单元测试、端到端测试）和CI工作流，但MCP服务器功能（远程MCP支持、stdio桥接）只是整个应用的一小部分，没有专门针对MCP握手和工具列出的测试。未提供清单文件，源码深度未验证。因此，可靠性得分受限于静态审查和缺乏直接的MCP特定证据。
安全与权限 12/20: 该应用有明确的安全模型：BYOK加密、本地优先存储、访问密码控制、破坏性工具调用需确认、对出站URL有安全检查。README声明了这些但未在源码中直接验证。部署指南明确说明自我托管并非公共SaaS安全边界。由于无法验证代码中的具体实现，且文档承认需要额外的生产强化措施，因此扣分。未发现红旗（如恶意软件或凭证盗窃）。
维护活跃度 14/20: 该仓库有多个版本（v2.4.0、v2.2.0等），公开变更日志，以及最近提交（关于README的日期为2025），并有CI和Docker工作流。许可证为MIT。虽有活跃维护证据，但未显示版本发布或问题响应节奏，依赖更新也未监控，因此扣分。
文档质量 14/20: README非常全面，涵盖安装、部署、配置、架构、安全模型和常见问题。有单独的文档目录（如部署加固、可靠性模型）以及环境变量和插件开发指南。虽然文档详细，但未提供MCP服务器本身的针对客户端的配置示例（如Claude Desktop配置），且MCP stdio桥接的文档未在材料中提供，因此扣分。
安装易用性 10/20: 安装步骤清晰：需要Node.js 22和pnpm，运行pnpm install和pnpm dev。针对Vercel和Cloudflare Workers有部署指南。然而，作为MCP服务器接入客户端的具体配置步骤不明确；README提到远程MCP服务器和stdio桥接，但没有直接的客户端配置示例。且未提供清单文件，因此扣分。

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

查看 FMRS 评分方法 →

选型与风险

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

适合谁

希望掌控数据并需要自托管 AI 聊天工作区的个人或团队
熟悉 Next.js、React 和 TypeScript 的开发者
需要多提供商集成和插件扩展的用户

不适合谁

需要现成 SaaS 安全边界（如账户、租户隔离）的公开多用户服务
不希望管理自身部署和配置的用户
需要原生 Agent 编排（浏览器端仅提供有限的 Agent 模式）的用户

所需权限

浏览器存储访问（localStorage、IndexedDB、OPFS）
网络访问以连接模型提供商、搜索、RAG、语音和 MCP 服务器
服务器端 API 路由执行插件、MCP 和代理请求
可选的服务端环境变量用于部署默认值和安全
Docker 部署可能暴露端口 3000

风险与副作用

自托管涉及安全责任；公开暴露需要额外加固
用户输入的提供商凭据在浏览器中加密，但服务器若配置不当可能暴露
托管模式依赖 Upstash 等共享存储，并限制网络策略
远程 MCP 服务器可能执行工具，需谨慎配置
数据默认存储在浏览器，清除浏览器数据可能导致丢失，除非备份或同步

安装接入

准备工作

运行环境：Node.js 22+ · Docker

ACCESS_PASSWORD 可选密钥部署访问口令，作为部署门槛而非账户系统。

BYOK_PRIVATE_KEY_PEM 可选密钥生产环境稳定的 BYOK 服务器私钥，用于加密用户输入的密钥。

UPSTASH_REDIS_REST_TOKEN 可选密钥 Upstash Redis REST 凭据，托管/多实例部署时用于共享短时状态。

DEFAULT_PROVIDER_API_KEY 可选密钥服务器默认模型提供商的 API 密钥，由各提供商（Google/Anthropic/OpenAI 等）获取。

DEFAULT_SEARCH_API_KEY 可选密钥外部搜索提供商（如 Tavily、Firecrawl）的密钥，可选，用于提高速率限制。

DEFAULT_RAG_TOKEN 可选密钥外部向量/RAG 服务的访问令牌。

DEFAULT_MINERU_API_TOKEN 可选密钥

DEFAULT_LLAMA_PARSE_API_KEY 可选密钥

DEFAULT_ELEVENLABS_API_KEY 可选密钥 ElevenLabs 语音服务的 API 密钥，在 ElevenLabs 官网获取。

DEFAULT_MIMO_API_KEY 可选密钥

其他可选配置项（40 个）

BYOK_KEY_ID 可选与 BYOK 私钥配套的密钥 ID。

BYOK_ALLOW_EPHEMERAL_KEY 可选是否允许临时 BYOK 密钥，本地可设 true，生产应设 false。

DEPLOYMENT_MODE 可选部署模式，local 或 hosted，托管部署应设为 hosted。

ALLOW_LOCAL_NETWORK_PROXY 可选

RATE_LIMIT_STORE 可选

DOCUMENT_PARSE_JOB_STORE 可选

PLUGIN_REGISTRY_STORE 可选

UPSTASH_REDIS_REST_URL 可选

DEFAULT_PROVIDER_TYPE 可选服务器默认提供商类型，如 Google、Anthropic、OpenAI、OpenAI Compatible。

DEFAULT_PROVIDER_NAME 可选

DEFAULT_PROVIDER_BASE_URL 可选

DEFAULT_PROVIDER_MODELS 可选

DEFAULT_MODEL_TITLE_GENERATION 可选

DEFAULT_MODEL_RELATED_QUESTIONS 可选

DEFAULT_MODEL_CONTEXT_COMPRESSION 可选

DEFAULT_MODEL_PROMPT_OPTIMIZATION 可选

DEFAULT_MODEL_RAG_QUERY 可选

DEFAULT_MODEL_MEMORY 可选

DEFAULT_SEARCH_PROVIDER 可选

DEFAULT_SEARCH_BASE_URL 可选

DEFAULT_RAG_BASE_URL 可选

DEFAULT_RAG_TOP_K 可选

DEFAULT_RAG_CHUNK_SIZE 可选

DEFAULT_RAG_NAMESPACE 可选

DEFAULT_DOCUMENT_PARSE_PROVIDER 可选

DEFAULT_VOICE_PROVIDER 可选

DEFAULT_ELEVENLABS_STT_MODEL 可选

DEFAULT_ELEVENLABS_TTS_MODEL 可选

DEFAULT_ELEVENLABS_TTS_VOICE_ID 可选

DEFAULT_MIMO_STT_MODEL 可选

DEFAULT_MIMO_TTS_MODEL 可选

DEFAULT_MIMO_TTS_VOICE_ID 可选

DEFAULT_SYSTEM_PROMPT 可选

DEFAULT_ENABLE_AUTO_TITLE 可选

DEFAULT_ENABLE_RELATED_QUESTIONS 可选

DEFAULT_ENABLE_AUTO_COMPRESSION 可选

DEFAULT_ENABLE_CODE_COLLAPSE 可选

DEFAULT_ENABLE_HTML_VISUAL_PROMPT 可选

NEXT_PUBLIC_SITE_URL 可选公开站点 URL，用于元数据和生成的公开链接。

TRUST_PROXY_HEADERS 可选

本地运行要求 Node.js 22 和 pnpm 10.30.3。使用 pnpm install 然后 pnpm dev 启动，打开 http://localhost:3000，并在设置中至少配置一个模型提供商。也可使用 Docker Compose（docker compose up --build）或 Docker 镜像（docker build -t neo-chat:local .）部署。支持部署到 Vercel 和 Cloudflare Workers。

验证是否装好

运行 pnpm install && pnpm dev 后打开 http://localhost:3000，在设置中至少配置一个模型提供商；能正常发起对话即说明安装成功。MCP 方面可在插件市场安装远程 MCP 服务器并看到其工具出现。

常见排障

检查 Node.js 和 pnpm 版本是否满足要求（Node 22、pnpm 10.30.3）
确保至少配置一个模型提供商
检查浏览器控制台和服务器日志中的错误
查看 /api/health 端点获取部署健康状态
验证环境变量如 BYOK_ALLOW_EPHEMERAL_KEY 是否设置正确
Docker 部署时确保端口映射和网络配置正确

试试这样问

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

帮我配置一个远程 MCP 服务器并安装其中的工具
用 OpenAI 兼容提供商新建一个聊天会话并生成一张图片
上传一份 PDF 到知识库并基于它提问
搜索我最近的聊天记录里关于项目计划的内容

使用场景

本地优先的 AI 聊天，保留数据所有权

多提供商聊天（Google、Anthropic、OpenAI 及兼容端点）

使用技能、插件和 MCP 服务器扩展功能

知识库 RAG 和本地全局搜索

端到端加密的跨设备同步

离线 PWA 支持

详细介绍

Neo Chat 是一个可自托管的、本地优先的 AI 聊天应用，基于 Next.js、React、TypeScript 和 Zustand 构建。它将多提供商聊天、助手预设、纯文本技能、OpenAPI 风格插件工具、远程 MCP 服务器和可选的本地 stdio 桥接、网页和本地全局搜索、知识库 RAG、可选加密的跨设备同步、版本化备份和恢复、本地记忆、离线 PWA、语音、生成媒体、富消息渲染、引文和可编辑工件整合到一个整洁的工作区中。它专为希望获得现代 AI 工作区强大功能同时保留本地数据所有权的用户设计。默认情况下，聊天历史、工作区元数据、技能、插件配置、记忆、搜索索引和文件保留在浏览器中；服务器路由充当模型提供商、网页搜索、RAG、文档解析、语音、插件和 MCP 执行以及部署健康检查的受控代理。