使用说明

项目简介

Archon是一个AI智能体构建工具，其MCP服务器组件旨在通过模型上下文协议（MCP）为AI集成开发环境（IDE）提供后端服务。该服务器允许IDE客户端（如Windsurf, Cursor, Cline/Roo Code）与Archon智能体服务进行交互，以实现智能体的创建、精细化和优化。

主要功能点

智能体构建服务: 通过自然语言指令，引导Archon自主创建基于Pydantic AI的AI智能体。
智能体精细化: 支持用户反馈和自主优化，通过专门的Refiner Agents改进Prompt、工具和智能体配置。
模型上下文协议 (MCP) 支持: 提供标准的JSON-RPC接口，使得AI IDE能够集成Archon的功能，实现上下文感知和功能调用。
资源管理: 通过Supabase数据库存储和管理文档资源，支持RAG（检索增强生成）功能，为智能体提供知识库。
工具注册与执行: 内置'create_thread'和'run_agent'工具，允许客户端创建对话线程并运行Archon智能体。
Prompt模板: 通过系统Prompt和用户输入，灵活控制智能体的行为和输出。
多种部署方式: 支持Docker容器化部署和本地Python环境运行。

安装步骤

请根据您的偏好选择以下安装方式之一：

Docker 安装 (推荐):

确保已安装 Docker。

克隆仓库:

git clone https://github.com/CCwithAi/Archon-v5.git
cd Archon-v5/archon/iterations/v4-streamlit-ui-overhaul

运行 Docker 启动脚本:
```
python run_docker.py
```
这将构建并启动包含MCP服务器的 Archon Docker 容器。

本地 Python 安装:

确保已安装 Python 3.11+。

克隆仓库:

git clone https://github.com/CCwithAi/Archon-v5.git
cd Archon-v5/archon/iterations/v4-streamlit-ui-overhaul

创建并激活虚拟环境:

python -m venv venv
source venv/bin/activate  # 或 venv\Scripts\activate (Windows)

安装依赖:

pip install -r requirements.txt

启动 Streamlit UI (MCP 服务器将随 Agent Service 一起启动):

streamlit run streamlit_ui.py

服务器配置

MCP 服务器配置 (JSON 格式，用于 MCP 客户端配置):

{
  "mcpServers": {
    "archon": {  // 服务器名称，客户端据此名称调用
      "command": "docker", // 启动服务器的命令，Docker 部署时使用 docker run
      "args": [ // 命令参数
        "run",
        "-i", // 保持STDIN开放，即使未连接
        "--rm", // 容器退出时自动删除容器
        "-e",
        "GRAPH_SERVICE_URL", // 传递环境变量
        "archon-mcp:latest" // Docker 镜像名称
      ],
      "env": { // 环境变量
        "GRAPH_SERVICE_URL": "http://host.docker.internal:8100" //  指向 Archon Graph Service 的 URL，Docker 部署时使用 host.docker.internal
      }
    }
  }
}

或

{
  "mcpServers": {
    "archon": {  // 服务器名称
      "command": "/path/to/venv/bin/python", // 启动服务器的命令，本地 Python 部署时使用 Python 解释器路径
      "args": [  // 命令参数
        "/path/to/Archon-v5/archon/mcp/mcp_server.py" // MCP 服务器脚本的路径
      ]
    }
  }
}

基本使用方法

启动 Archon MCP 服务器: 按照上述安装步骤启动 Archon，MCP 服务器将自动运行。
配置 MCP 客户端: 在您的 AI IDE (如 Windsurf, Cursor, Cline/Roo Code) 中，根据 "服务器配置" 部分提供的 JSON 配置信息，配置 MCP 服务器连接。
使用 MCP 工具: 在 IDE 中，您可以通过 MCP 客户端调用 Archon MCP 服务器提供的工具，例如：
- 'create_thread()': 创建一个新的对话线程，返回线程 ID。
- 'run_agent(thread_id: str, user_input: str)': 在指定线程 ID 中运行 Archon 智能体，传递用户输入，并获取智能体生成的代码或其他响应。

注意: 在首次与 Archon 进行对话前，务必先调用 'create_thread()' 工具获取线程 ID，并在后续的 'run_agent' 调用中重用该 ID 以维持对话上下文。

关键词

使用说明

信息