flux-topology

정적 분석을 통해 Kubernetes/FluxCD GitOps 저장소의 의존성 및 토폴로지 그래프를 구축하는 MCP 서버입니다. AI 에이전트가 클러스터 접근 없이 서비스 간 관계를 추론할 수 있게 해 줍니다.

설치

pip install flux-topology

Related MCP server: Axon Pro

MCP 구성

opencode.json에 다음을 추가하세요:

{
  "mcp": {
    "flux-topology": {
      "type": "local",
      "command": ["flux-topology", "mcp"],
      "enabled": true
    }
  }
}

서버는 작업 디렉터리의 flux/에서 읽습니다. GitOps 저장소 루트에서 opencode를 실행하세요.

에이전트 스킬

번들로 제공되는 에이전트 스킬은 AI 에이전트에게 MCP 도구를 언제, 어떻게 사용하는지 알려줍니다. skills.sh에서 설치하세요:

npx skills add seppaleinen/flux-topology-mcp

이를 통해 에이전트는 다음과 같은 워크플로를 갖게 됩니다. 개요는 fluxtop_map으로 파악하고, fluxtop_app_card로 세부 정보를 확인하고, fluxtop_trace로 영향 범위(blast radius)를 확인한 다음, fluxtop_find_refs로 공유 참조를 찾습니다.

도구

CLI

# Build the topology cache (.fluxtop/)
flux-topology build

# Run the MCP server (for AI agents)
flux-topology mcp

작동 방식

1. 탐색: flux/를 순회하며 소유권 신호(HelmReleases, Kustomizations, Deployments, Services)를 찾아 앱을 식별합니다.

2. 추출: 앱별로 워크로드, 서비스, 인그레스 호스트, 참조를 추출합니다.

3. 해석: 교차 참조에서 앱 간 엣지를 해석합니다.

4. 캐시: 모든 것을 .fluxtop/에 캐시하며, 소스 파일이 변경된 경우에만 다시 빌드됩니다.

클러스터 접근이 필요하지 않습니다. YAML 파일의 순수 정적 분석입니다.

개발

git clone https://github.com/seppaleinen/flux-topology-mcp.git
cd flux-topology-mcp
pip install -e ".[dev]"
pytest

라이선스

MIT