Archon MCP服务器
Archon知识管理系统的轻量级MCP(模型上下文协议)服务器微服务。
概述
此MCP服务器为AI助手与Archon系统交互提供工具和协议处理。它通过HTTP与其他Archon服务通信,并公开MCP工具用于:
- RAG查询和知识库搜索
- 代码示例检索
- 项目和任务管理(启用时)
- 源管理
铁路部署

人工铁路部署
- 分叉此存储库
- 在铁路上创建新项目
- 连接您的GitHub存储库
- 添加以下环境变量:
- SUPABASE_URL:您的Supabase项目URL - SUPABASE_SERVICE_KEY:您的Supabase服务密钥 - SERVICE_AUTH_KEY:用于服务到服务身份验证的安全密钥 - ARCHON_SERVER_URL:主Archon服务器的URL(例如。, http://archon-server.railway.internal:8181) - ARCHON_AGENTS_URL:代理服务的URL(例如。, http://archon-agents.railway.internal:8052) - LOGFIRE_TOKEN (可选):用于可观察性
- 部署!
地方发展
先决条件
- Python 3.11+
- pip或uv包管理器
设置
- 克隆存储库:
git clone https://github.com/yourusername/archon-mcp-server.git
cd archon-mcp-server- 安装依赖项:
pip install -r requirements.txt- 复制
.env.example向.env并配置:
cp .env.example .env
# Edit .env with your configuration- 运行服务器:
python -m src.mcp_server.mcp_server服务器将于启动 http://localhost:8051
Docker构建
构建Docker镜像:
docker build -t archon-mcp .使用Docker运行:
docker run -p 8051:8051 --env-file .env archon-mcp健康检查
服务器在以下位置公开健康端点 /health 返回:
200 OK:服务器运行正常503 Service Unavailable:服务器不正常或依赖项不可用
建筑
这是一个轻量级的微服务,它:
- 与其他Archon服务使用基于HTTP的通信
- 实现用于AI助手集成的MCP协议
- 保持最小的依赖关系(~150MB容器大小)
- 支持水平缩放
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
SUPABASE_URL | 是 | 请提供项目URL |
SUPABASE_SERVICE_KEY | 是 | 请提供服务密钥 |
SERVICE_AUTH_KEY | 是 | 服务到服务身份验证密钥 |
ARCHON_SERVER_URL | 是 | 主Archon服务器URL |
ARCHON_AGENTS_URL | 是 | 代理服务URL |
PORT | 无 | 服务器端口(默认:8051) |
LOGFIRE_TOKEN | 否 | 用于可观察性的Logfire令牌 |
LOG_LEVEL | 否 | 日志记录级别(默认值:INFO) |
许可证
麻省理工学院
