vantage-mcp-server

Vantage MCP 서버

Vantage MCP 서버 정보

Vantage MCP 서버는 Golang으로 작성된 오픈 소스 도구로, AI 어시스턴트와 MCP 클라이언트를 통해 클라우드 비용 데이터와 상호 작용할 수 있도록 지원합니다. Vantage MCP 서버는 Vantage의 기존 API를 연결하는 다리 역할을 하며, 자연어를 사용하여 클라우드 지출 데이터를 쿼리하고 비용 분석을 더욱 직관적으로 수행할 수 있도록 지원합니다.

📝 참고: 현재 Vantage MCP 서버는 표준 입출력(stdio) 전송을 사용하는 로컬 실행 서비스로만 제공됩니다. 즉, 사용자의 컴퓨터나 서버에서 실행하고 MCP 클라이언트와 통합해야 합니다.

사용 가능한 도구

Vantage MCP 서버는 현재 다음과 같은 도구를 제공하고 있으며, 이러한 도구는 호환 가능한 모든 MCP 클라이언트(예: Claude, Cursor, Goose)에서 호출할 수 있습니다.

• query-costs
  • VQL을 사용하여 비용 데이터를 가져오는 일반적인 방법.
• list-costs
  • 연관된 비용 보고서에 모든 비용을 표시합니다.
• list-cost-reports
  • 사용 가능한 모든 비용 보고서를 나열합니다.
• get-cost-report-forecast
  • 비용 보고서와 관련된 모든 지출 예측을 나열합니다.
• list-cost-integrations
  • 비용 데이터를 제공하는 데 사용할 수 있는 모든 비용 제공자 통합(예: AWS, Azure, GCP)과 관련 계정을 나열합니다.
• list-cost-providers
  • 지정된 작업 공간이 공유한 공급자만 나열한 목록입니다.
• list-cost-services
  • 지정된 작업 공간과 공유되는 모든 서비스와 관련 공급자를 나열합니다.
• list-budgets
  • 비용 보고서와 비교하고 지출을 추적하기 위해 사용 가능한 모든 예산을 나열합니다.
• list-dashboards
  • Vantage 계정에서 생성된 모든 대시보드를 나열합니다.
• list-tags
  • 비용 보고서를 필터링하는 데 사용할 수 있는 태그 목록입니다.
• list-tag-values
  • 비용 보고서를 필터링하는 데 사용할 수 있는 태그 값을 나열합니다.
• list-anomalies
  • 비용 보고서에서 감지된 이상을 나열합니다.
• list-cost-providers
  • VQL 쿼리에서 비용을 필터링하는 데 사용할 수 있는 비용 공급자를 나열합니다.
• list-unit-costs
  • 주어진 비용 보고서에 대한 단위 비용을 검색합니다.
• get-myself
  • 사용 가능한 작업 공간을 나열하고 인증 토큰의 액세스 수준을 확인하는 유틸리티입니다.
• submit-user-feedback
  • MCP 또는 전반적인 Vantage 경험에 대한 피드백을 Vantage 팀에 보내는 간단한 방법입니다.

시작하기

필수 조건

소스에서 설치하는 경우 다음 패키지가 설치되어 있는지 확인하세요(정확한 버전은 .tool-versions 참조).

• 가다
• 노드.js

버전 관리자(예: asdf )나 패키지 관리자(예: Homebrew )를 사용하여 이러한 종속성을 설치할 수 있습니다.

읽기 전용 Vantage API 토큰도 생성해야 합니다(현재 쓰기 기능은 작동하지 않습니다). Vantage API 설명서 의 지침을 따르세요. MCP 서버에서만 사용할 새로운 읽기 전용 API 토큰을 생성하는 것이 좋습니다.

설치

Homebrew 사용

지엑스피1

출처에서

1. 이 저장소를 복제합니다.

2. 서버를 빌드하고 권한을 조정합니다.

📝 참고: 저장소에서 새로운 변경 사항을 끌어오는 경우 go build 다시 실행하여 서버를 다시 빌드하고 최신 버전을 실행하고 있는지 확인하세요.

3. MCP 검사기를 사용하여 디버깅합니다.

MCP 클라이언트 설정

설정 지침은 사용하는 MCP 클라이언트에 따라 다릅니다. 예시 클라이언트는 다음과 같습니다.

• 데스크톱용 클로드
• 커서
• 거위

사용 가능한 클라이언트 목록은 MCP 설명서를 참조하세요. Claude for Desktop, Cursor, Goose에 대한 자세한 지침은 아래에 나와 있습니다.

데스크톱용 클로드

1. 데스크톱용 Claude를 다운로드하세요.
2. 데스크톱용 Claude 상단에서 Claude > 설정 (단축키 Command + , )을 클릭합니다.
3. 설정 창의 왼쪽 메뉴에서 개발자를 선택합니다.
4. '구성 편집'을 클릭하세요. 구성 파일은 다음 위치에 생성됩니다.

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• 윈도우 : %APPDATA%\Claude\claude_desktop_config.json

5. claude_desktop_config.json 파일을 열고 내용을 업데이트하세요. <path_to_compiled_vantage_mcp_server_binary> 자리 표시자를 Vantage MCP 서버 바이너리를 다운로드한 경로로, <personal_vantage_api_token> 자리 표시자를 Vantage API 토큰으로 변경하세요.
   { "mcpServers": { "Vantage": { "command": "<path_to_compiled_vantage_mcp_server_binary>", "args": [], "env": { "VANTAGE_BEARER_TOKEN": "<personal_vantage_api_token>" } } } }
6. 구성 파일을 저장하고 Claude를 다시 시작합니다.
7. Claude for Desktop 입력 상자의 오른쪽 하단에 있는 망치 아이콘을 클릭하면 Vantage MCP Server에서 사용할 수 있는 도구를 확인할 수 있습니다.
8. 구성을 완료하면 Claude에게 메시지를 보낼 수 있습니다. 새 도구를 사용할 때마다 Claude는 진행하기 전에 사용자의 승인을 요청합니다.

커서

1. 커서를 다운로드하세요.
2. 커서를 열고 메뉴 표시줄에서 커서 > 설정 > 커서 설정을 클릭합니다.
3. 왼쪽 창에서 MCP를 선택합니다.
4. 새로운 글로벌 MCP 서버 추가를 클릭합니다.
5. 열린 mcp.json 파일의 내용을 업데이트하세요. <path_to_compiled_vantage_mcp_server_binary> 자리 표시자를 Vantage MCP 서버 바이너리를 다운로드한 경로로, <personal_vantage_api_token> 자리 표시자를 Vantage API 토큰으로 변경하세요.
   { "mcpServers": { "Vantage": { "command": "<path_to_compiled_vantage_mcp_server_binary>", "args": [], "env": { "VANTAGE_BEARER_TOKEN": "<personal_vantage_api_token>" } } } }

거위

1. Goose를 다운로드하세요.
2. Goose를 열고 메뉴 막대에서 Goose > 설정을 클릭합니다(단축키 Command + , ).
3. 확장 프로그램 섹션에서 사용자 지정 확장 프로그램 추가를 클릭합니다.
4. ID 필드에 vantage-mcp-server 입력합니다.
5. 이름 필드에 Vantage 입력합니다.
6. 설명 필드에 Query costs and usage data 입력합니다.
7. 명령 필드에 Vantage MCP 서버 바이너리의 경로를 입력합니다.
8. 환경 변수 섹션에서 VANTAGE_BEARER_TOKEN 이라는 이름의 새 변수를 추가하고 값을 Vantage API 토큰으로 설정합니다.
9. 추가를 클릭합니다.

MacOS 사용자를 위한 참고 사항

Github 페이지에서 릴리스를 다운로드했는데 "개발자를 확인할 수 없어" 실행 파일이 실행되지 않는 경우, 시스템 설정을 열어주세요. 그런 다음 "개인 정보 및 보안" 섹션을 찾으세요. 그런 다음 아래로 스크롤하면 "vantage-mcp-server-macos"가 차단되었다는 메시지가 표시될 것입니다. "무시하고 열기" 버튼을 클릭하세요. 이 과정을 마치면 실행 파일은 문제없이 실행될 것입니다.

기여 지침

이 프로젝트에 기여하고 싶다면:

1. 이 저장소를 포크하세요.
2. 새로운 브랜치를 만듭니다: git checkout -b feature/my-feature .
3. 변경 사항을 적용하세요.
4. 코드가 형식화되어 있고 깔끔하게 빌드되는지 확인하세요.
5. 풀 리퀘스트를 제출하세요.

커뮤니티 기여, 개선 사항, 버그 수정을 환영합니다. 문제가 발생하면 이 저장소의 GitHub Issues를 통해 버그 리포트를 제출해 주세요.

특허

상업적 및 비상업적 라이센스에 대한 자세한 내용은 LICENSE.MD 파일을 참조하세요.