vibops-mcp
License: MIT
Python 3.11+
MCP Tools
Tests
VibOps — AI 인프라 엔진을 위한 MCP 서버입니다. 코드부터 GPU까지 하나의 대화로 구현합니다.
문제점 (The problem)
AI 앱을 코드를 작성하는 단계에서 GPU를 사용하는 프로덕션 환경으로 가져가려면 git, Docker, CI/CD, Helm, kubectl, GPU 모니터링, 비용 관리, 규정 준수(compliance), 알림(alerting) 등 9가지 이상의 도구를 연결해야 합니다. 각 도구는 자체 API, 대시보드, 그리고 비용 모델을 가지고 있습니다. 이 모든 파이프라인을 아우르는 단일 인터페이스가 없습니다.
해결책 (The solution)
vibops-mcp는 AI 비서와 VibOps에 연결합니다. VibOps는 어떤 GPU, 어떤 클러스터, 어떤 클라우드에서 앱과 에이전트를 복제(clones), 빌드(builds), 배포(deploys), 확장(scales), 모니터링(monitors), 수정(fixes), 그리고 청구(bills)하는 엔진입니다. 단 한 번의 pip install로 117개의 도구를, 하나의 대화로 사용합니다.
- 배포 (Ship) — 리포지토리를 복제하고, 컨테이너를 빌드하며, 모델을 배포하고, Helm/kubectl을 실행하며, 파이프라인을 트리거하고, Slurm 작업을 제출합니다.
- 운영 (Operate) — 배포를 확장하고, VM(Proxmox/XO/vSphere/HPE VME)을 관리하며, GPU 이상 징후를 감지하고 수정합니다.
- 관찰 (Observe) — GPU 사용률, 워크로드 분석, MTTR, 비용 추정치, 실시간 K8s 배포 현황을 확인합니다.
- 거버넌스 (Govern) — AI Act 규정 준수, SOC 2/RGPD 보고서, 불변의 감사 체인(immutable audit chain), 정책 관리를 수행합니다.
- 재무 운영 (FinOps) — 에이전트별 비용 추적, 예산 강제 적용, 비용 전가(chargeback), 지출 추세 분석, 자원 낭비 분석을 제공합니다.
모든 작업은 사용자의 VibOps 인스턴스를 거치며 불변의 감사 로그에 기록됩니다.
설치 (Installation)
pip install git+https://github.com/VibOpsai/vibops-mcp.git
버전이 출시된 버전은 PyPI에서도 사용할 수 있습니다. 특정 버전을 고정하고 싶다면 다음 명령어를 사용하세요:
설정 (Configuration)
두 가지 환경 변수가 필요합니다:
| Variable | Description |
|---|
VIBOPS_URL | VibOps 인스턴스의 기본 URL입니다. 예: https://vibops.example.com |
VIBOPS_TOKEN | API 토큰입니다 — VibOps → Settings → API Tokens에서 생성합니다. |
클라이언트 연결 (Connecting your client)
vibops-mcp는 Model Context Protocol을 사용하므로, 동일한 서버 항목이 모든 MCP 호환 클라이언트에서 작동합니다. 이를 클라이언트의 MCP 설정에 추가하세요:
{
"mcpServers": {
"vibops": {
...
해당 파일의 위치는 클라이언트에 따라 다릅니다:
| Client | Configuration file |
|---|
| Claude Desktop | ~/.config/claude/claude_desktop_config.json — macOS의 경우, ~/Library/Application Support/Claude/claude_desktop_config.json |
| Cursor | 프로젝트 루트에 있는 .cursor/mcp.json, 또는 전역 설정 |
다른 MCP 클라이언트들은 자체 구성 파일에서 동일한 블록을 읽습니다. 위치는 사용 중인 클라이언트의 문서를 참조하세요. 일부는 수동으로 파일을 편집하는 대신 해당 항목을 작성해주는 명령어를 제공합니다.
Observation (16개 도구 — 읽기 전용)
| Tool | Description |
|---|
list_clusters | 클러스터 목록 및 GPU 활용률 보기 |
| ... | |
Actions (18개 도구 — 쓰기)
| Tool | Description |
|---|
scale_deployment | K8s 배포 복제본 수 조정 |
| ... | |
HPE VME / Morpheus (13개 도구)
| Tool | Description |
|---|
vme_list_instances | HPE VME에서 관리하는 모든 VM 목록 보기 |
| ... | |
Hypervisors — Proxmox, vSphere, Xen Orchestra (30개 도구)
가장 마지막에 문서화되었으며 여기에 전체 목록으로 나열되어 있습니다: 이들은 등록되고 제공되었지만 이 README에는 누락되어 있어, 섹션을 세는 독자는 첫 줄에서 약속한 117개 중 87개를 발견했습니다. 이제 그 숫자가 맞습니다.
Proxmox VE (5개 도구)
| Tool | Description |
|---|
proxmox_list_vms | 클러스터 전체의 VM 목록, 상태 및 크기 보기 |
| ... | |
| VMware vSphere (9개 도구) | |
| Tool | Description |
|---|
vsphere_list_vms | 전원 상태, 호스트 및 리소스와 함께 VM 목록 보기 |
| ... | |
| Xen Orchestra / XCP-ng (15개 도구) | |
| Tool | Description |
|---|
xo_list_vms | 모든 풀(pool)에 걸친 VM 목록 보기 |
| ... | |
| Cross-hypervisor | |
| Tool | Description |
|---|
get_vm_usage | 모든 선언된 하이퍼바이저(hypervisor)의 VM 사용량 및 비용 |
| Tool | Description |
|---|
set_cluster_rate | 클러스터의 GPU 비용률 설정 (관리자 전용) |
| ... | |
AI 에이전트와 GPU 플릿 사이에 존재하는 누락된 계층. 모든 프레임워크(n8n, LangChain, CrewAI, Dify)에서 작동하며, VibOps LLM Proxy만 지정하면 됩니다.
| Tool | Description |
|---|
| FinOps per agent | |
| ... | |
| Tool | Description |
|---|
list_anomalies | 선택적 클러스터/상태 필터를 사용하여 GPU 이상 징후 목록 보기 |
| ... | |
| Tool | Description |
|---|
get_budget | 현재 GPU 예산 및 소비된 지출량 가져오기 |
| ... | |
LLM 추론 프록시 (LLM Inference Proxy)
VibOps는 AI 에이전트와 LLM 추론 서버(vLLM, Ollama, TGI) 사이에 위치하는 투명한 OpenAI 호환 프록시(포트 8004)를 포함합니다. 모든 추론 요청은 FinOps를 위해 에이전트 기여도와 함께 기록됩니다.
에이전트는 LLM을 직접 가리키는 대신 프록시를 가리킵니다:
# 이전 방식
OPENAI_BASE_URL=http://vllm:8000/v1
...
다음과 같이 X-VibOps-Agent-Id 헤더를 추가하여 에이전트별 비용을 기여시킵니다:
curl -X POST http://vibops-proxy:8004/v1/chat/completions \
-H
이는 [FastMCP](https://github.com/jlowin/fastmcp)와 [VibOps](https://vibops.ai) — AI 인프라 엔진을 기반으로 구축되었습니다.