模型上下文协议服务器

ArchonMCPServer 是一个为 Archon RAG 系统设计的模型上下文协议服务器,将 Archon 的知识库作为标准化工具暴露给 LLM 客户端,用于基于上下文的决策支持。

  • by bdchatham
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 bdchatham/ArchonMCPServer

使用说明

ArchonMCP服务器

用于Archon RAG系统的MCP(模型上下文协议)服务器。将Archon的知识库公开为LLM客户(Kiro、Claude Desktop、Cursor)可以发现和调用的标准化工具,以进行有根据的决策。

这是什么?

ArchonMCPServer使用符合MCP的HTTP API封装了Archon查询服务,允许AI助手:

  • 在内部Archon/Aphex文档中搜索
  • 检索完整文档以获取详细上下文
  • 列出知识库中的可用存储库

这使得 有根据的、引用支持的回复 而不是对内部架构的幻觉假设。

快速开始

本地开发

# Install dependencies
pip install -e .

# Set Query Service URL (optional, defaults to Kubernetes service)
export QUERY_SERVICE_URL=http://localhost:8080

# Run server
python -m archon_mcp

服务器在上运行 http://localhost:8090

码头工人

docker build -t archon-mcp-server .
docker run -p 8090:8090 \
  -e QUERY_SERVICE_URL=http://query.archon-knowledge-base:8080 \
  archon-mcp-server

Kubernetes

看 .kiro/docs/operations.md 以获取部署说明。

可用工具

archon.search

在内部文档中搜索排名结果和出处。

{
  "name": "archon.search",
  "arguments": {
    "query": "How do I deploy a service?",
    "top_k": 5,
    "repo_filter": "AphexPlatformInfrastructure"
  }
}

archon.get_document

获取详细上下文的完整文档文本。

{
  "name": "archon.get_document",
  "arguments": {
    "doc_id": "uuid-from-search-results"
  }
}

archon.list_repos

列出知识库中的可用存储库。

{
  "name": "archon.list_repos",
  "arguments": {}
}

与Kiro集成

Kiro CLI在以下情况下会自动使用这些工具 .kiro/steering/archon-rag.md 存在指导文件(包含在ArchonKiroTemplate中)。

转向确保Kiro:

  • 在做出实施决策之前调用MCP工具
  • 引用检索到的段落中的主张
  • 明确说明信息何时无法验证

建筑

ArchonMCPServer是一个精简的FastAPI包装器 AphexServiceClients.QueryClient:

graph TD
    A[Kiro CLI] -->|HTTP/MCP| B[ArchonMCPServer]
    B -->|QueryClient| C[Query Service :8080]
    C --> D[Qdrant 1.16.3]
    
    style B fill:#e1f5ff
    style C fill:#fff4e1
    style D fill:#f0f0f0

看 .kiro/docs/architecture.md 详细设计。

文档

完整的文件 .kiro/docs/:

  • overview.md -高层目的和背景
  • architecture.md -系统设计和组件
  • operations.md -部署和操作程序
  • api.md -MCP协议和工具模式
  • data-models.md -请求/响应结构
  • faq.md -常见问题和故障排除

许可证

[添加您的许可证]