Archon

Archon是什么？

Archon是一个开源AI编码助手操作系统（Beta），基于 Model Context Protocol（MCP）连接 Claude Code、Cursor、Windsurf 等多款 AI 工具，提供知识库管理、智能文档检索（RAG）、项目与任务协作、实时进度追踪等功能，让多个 AI 共享上下文高效协作，全面提升 AI 编程与团队开发效率。

核心功能

1. 知识管理

• 文档接入：抓取整站文档、上传 PDF/Word/Markdown/纯文本
• 智能分块与索引：结合向量搜索与 RAG 策略提升检索精准度
• 代码示例提取：自动识别文档中的代码示例并加入索引
• 知识源管理：按来源、类型、标签组织文档

2. AI 集成

• MCP 协议支持：与 Claude Code、Cursor 等兼容
• 多模型兼容：支持 OpenAI、Google Gemini、Ollama 等
• 高级 RAG 检索：混合搜索 + 语义向量检索 + 结果重排
• 实时流式响应：AI 代理执行任务时可实时回传进度

3. 项目与任务管理

• 层级化项目结构：项目 → 模块/功能 → 任务
• AI 辅助生成任务：可根据需求文档自动生成任务清单
• 版本化文档管理：多人协作编辑、版本跟踪
• 实时进度跟踪：支持 WebSocket 实时同步

4. 协作与架构

• 多用户协作：多人同时构建知识库与管理任务
• 微服务架构：前端 UI、核心 API、MCP Server、AI 代理独立部署
• 可扩展：未来可增加更多 AI Agent 与上下文工程能力

适用场景

• AI 参与的多成员软件研发项目
• 技术文档知识库管理与语义搜索
• AI 驱动的代码生成与重构协作
• 长期任务与进度管理

Archon官网及使用教程

开源地址：https://github.com/coleam00/Archon

一、安装与部署

1. 环境准备

必备：Docker Desktop、Node.js 18+、Supabase 账号（免费套餐即可）、OpenAI API Key（可选支持 Gemini、Ollama）。

可选：make（方便本地开发）

2. 克隆仓库

git clone https://github.com/coleam00/archon.git
cd archon

3. 配置环境变量

cp .env.example .env
# 修改 .env，填入 Supabase URL 和 Service Key
# SUPABASE_URL=https://your-project.supabase.co
# SUPABASE_SERVICE_KEY=your-service-key

4. 初始化数据库：在 Supabase SQL 编辑器中运行 migration/complete_setup.sql 脚本，创建 Archon 所需的表与索引。

5. 启动服务（推荐全 Docker 模式）

docker compose up –build -d
# 或使用
docker compose –profile full up –build -d

启动的核心服务：

• UI：Web 界面（默认端口 3737）
• Server：核心 API 与业务逻辑（8181）
• MCP Server：AI 编码助手协议接口（8051）
• Agents：AI 执行与流式响应（8052）

二、基础使用

1. 配置 API Key：打开 http://localhost:3737，进入 Settings → 选择 LLM / Embedding Provider → 填入 API Key。

2. 管理知识库

• 上传文档：PDF、Word、Markdown、TXT
• 抓取网站：输入站点或文档 URL，自动全站爬取与分块索引
• 代码示例提取：自动识别文档中的代码并存入索引
• 支持按来源、标签、类型分类管理

3. 项目与任务管理：创建项目 → 按功能模块添加任务，AI自动生成任务清单，支持任务进度实时更新。

4. 与 AI 编码助手连接：打开 MCP Dashboard → 复制连接配置，在 Claude Code、Cursor 等客户端配置 MCP 接口，接入 Archon 知识与任务系统。