Arkon 是一个开源自托管的企业级知识管理与 MCP(Model Context Protocol,模型上下文协议)服务器,目的是在组织数据与 AI 客户端之间建立受治理的中间层。它作为集中式 MCP Server 运行,把组织内的 SOP、政策与内部文档编译成结构化、可追溯的知识 wiki,再通过单一权限范围的端点提供给 Claude 及其他 LLM。资料指出,多数组织的 AI 采用是碎片化的——员工把文档复制粘贴进聊天机器人,导致上下文不一致、安全风险与重复劳动;Arkon 将 AI 视为受管理的组织资源,让每位员工按部门与角色自动、安全地获得正确上下文。
一、智能知识 Wiki 与 MRP 流水线 与只做分块索引的向量数据库不同,Arkon 的 MRP 流水线(Map → Reduce → Plan-review → Refine → Verify → Commit)把文档编译为互链页面的连贯 wiki。其特点包括:写入前先计划评审,每次摄入生成可人工审核的计划,列出将创建或更新哪些 wiki 页面,编辑者可在页面写入前带反馈重新生成计划;以页面合并取代覆盖,新来源触及已有页面时由 LLM 合并内容,避免旧知识丢失;可追溯声明,每个页面记录其编译自的源文档;图像感知,视觉说明在编译前写入源文本;可恢复,草稿在流水线中途持久化,崩溃后可续跑而无需重做昂贵的 LLM 工作。
二、Wiki 浏览器与知识图谱 提供三栏布局(页面树、内容、反向链接与出链)、全文与语义(pgvector)搜索、交互式知识图谱可视化(按作用域或全局)、页面间 wikilink 风格交叉引用、每页版本历史与回滚,以及草稿提案 → 编辑审核 → 批准的工作流。
三、部门与全局作用域 支持精确的上下文边界,每个范围拥有自己的作用域 wiki、文档集与部门名册。HR、法务、工程等部门级隔离,另有全局作用域用于公司级 SOP、政策与通用知识。在 API、MCP 与搜索层强制作用域,成员只能看到所属部门或全局范围的知识。
四、细粒度 RBAC 在部门与全局层面提供基于角色的访问控制,内置 Viewer、Contributor、Editor、Admin 角色以控制草稿、编辑与设置访问;支持 granular 权限(如 doc:read:own_dept、wiki:edit:all、org:settings:manage 等);并记录每次特权操作(设置变更、计划批准、角色更新)的审计日志。
五、面向 Claude 及其他 AI 客户端的 MCP Server 员工通过 OAuth 2.1 + PKCE 把 Claude Desktop 或 Claude.ai 连接到 Arkon,只需添加服务器 URL 并在浏览器中登录,无需手动复制令牌。MCP 服务器暴露的工具包括:Wiki 工具(search_wiki、read_wiki_page、list_wiki_pages、read_wiki_index);来源钻取(get_source、get_source_outline、get_source_pages、list_sources);编辑工作流(propose_wiki_edit、edit_wiki_page、list_pending_drafts、review_draft、approve_draft、reject_draft);发现类(list_knowledge_types、get_knowledge_type_docs)。所有工具按令牌作用域(部门、知识类型、来源列表)强制执行。
六、AI 技能分发 可一次上传自定义 agent 包并在组织内分发,支持带 SKILL.md 的版本化技能包(.zip)、部门作用域可见性,以及面向最终用户更新的贡献工作流。
七、可插拔 AI 提供商 以目录驱动选择,管理员从带上下文窗口、成本与能力元数据的精选列表中选择。LLM 支持 Anthropic Claude(Opus / Sonnet / Haiku 4.x)、Google Gemini(3.x Pro / Flash / Flash-Lite、2.5)、OpenAI(GPT-5.x、GPT-4.x);嵌入支持 Google gemini-embedding-* 与 OpenAI text-embedding-3-*,可切换并在线重嵌入迁移(完成后原子切换活跃模型,无零结果搜索窗口);视觉支持 Google Gemini Flash 与 OpenAI GPT-4o 系列。
八、隐私与安全 自托管,可通过 Docker 部署在本地或私有云;无遥测,出站流量仅发往所选 AI 提供商;静态加密,API 密钥在 PostgreSQL 中以 Fernet 加密存储。技术栈:后端为 FastAPI、PostgreSQL + pgvector、Redis(arq workers)、MinIO;前端为 Next.js、Tailwind CSS;AI 集成通过 FastMCP 使用 MCP;文档解析支持 PDF、DOCX、DOC、纯文本、URL 与内嵌图片。
九、服务器要求与快速开始 Arkon 运行 7 个 Docker 容器(PostgreSQL + pgvector、Redis、MinIO、FastAPI API、2 个 ARQ worker、Next.js 前端)。RAM 是主要瓶颈,MRP 流水线 worker 在 wiki 编译期间会把大 LLM 上下文窗口载入内存;存储随文档语料扩展(pgvector 索引、MinIO 文件存储与 PostgreSQL WAL 日志是主要消耗者)。所有 AI 推理在外部完成(Anthropic / Google / OpenAI API),因此不需要 GPU。生产环境建议使用带 SSL 的反向代理(Nginx / Caddy)。
快速开始(Docker): 前置条件为 Docker 与 Docker Compose,以及来自所选 AI 提供商(Anthropic、Google 或 OpenAI)的 API 密钥。 克隆仓库: git clone https://github.com/nduckmink/arkon.git cd arkon 配置环境: cp .env.docker.example .env.docker
Edit .env.docker - set SECRET_KEY, admin credentials, and Postgres/MinIO secrets
启动: docker compose --env-file .env.docker up -d --build 在 http://localhost:3119 访问门户,以管理员登录,然后到 Settings 选择嵌入 / LLM / 视觉模型并粘贴 API 密钥。完整环境变量参考见 Setup Guide。
连接 Claude:在 Claude Desktop 或 Claude.ai 的 Settings → Connectors 添加自定义连接器,URL 填 https://your-arkon-server/mcp,点击 Connect 后在浏览器中登录 Arkon 凭据即可。Arkon 使用 OAuth 2.1 + PKCE,无需手动令牌设置。若要让 Claude 持续使用 Arkon,可在 Claude 的 Custom Instructions 中添加说明;更强约束的做法是在 Claude Desktop 创建 Project,将 Arkon 作为连接器附加,并将相同文本粘贴为 Project Instructions。
十、其他能力与限制 资料还列出以下能力(部分标注为后续或附加功能):MRP 流水线、MCP Server、部门与全局作用域、Wiki 草稿与修订工作流、AI 技能、目录驱动的模型选择、在线嵌入迁移、审计日志、富媒体摄入(含图片、视频与 Excel 表格解析)、用量分析仪表盘、外部数据导入(SharePoint、Google Drive、Notion 等连接器)、Arkon CLI、通知系统。Arkon 采用 PolyForm Internal Use License 1.0.0:企业内部业务运营免费,不得将 Arkon 作为服务提供给第三方。资料同时指出,Arkon 面向团队而非个人;个人知识场景更适合 Obsidian + Claude Skills。主要作者为 Minh Nguyen(越南,GMT+7)。API 密钥、成本参数等具体价格信息资料暂未提供。