AI导哈

MCP服务器微服务

Archon MCP Server是一个轻量级的MCP服务器微服务，为AI助手与Archon知识管理系统交互提供工具和协议处理。

  • by SirThomasRipley
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 sirthomasripley/archon-mcp-server

使用说明

Archon MCP服务器

Archon知识管理系统的轻量级MCP（模型上下文协议）服务器微服务。

概述

此MCP服务器为AI助手与Archon系统交互提供工具和协议处理。它通过HTTP与其他Archon服务通信，并公开MCP工具用于：

  • RAG查询和知识库搜索
  • 代码示例检索
  • 项目和任务管理（启用时）
  • 源管理

铁路部署

人工铁路部署

  1. 分叉此存储库

  2. 在铁路上创建新项目

  3. 连接您的GitHub存储库

  4. 添加以下环境变量：

    • 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 （可选）：用于可观察性

  5. 部署！

地方发展

先决条件

  • Python 3.11+
  • pip或uv包管理器

设置

  1. 克隆存储库：
git clone https://github.com/yourusername/archon-mcp-server.git
cd archon-mcp-server
  1. 安装依赖项：
pip install -r requirements.txt
  1. 复制 .env.example 向 .env 并配置：
cp .env.example .env
# Edit .env with your configuration
  1. 运行服务器：
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）

许可证

麻省理工学院

相关 MCP