vantage-mcp-server

Servidor Vantage MCP

Acerca del servidor Vantage MCP

El servidor MCP de Vantage es una herramienta de código abierto, desarrollada en Golang, que permite interactuar con los datos de costes de la nube mediante asistentes de IA y clientes MCP. Al actuar como puente con las API existentes de Vantage, el servidor MCP de Vantage permite consultar los datos de gasto en la nube con lenguaje natural y facilita el análisis de costes.

📝 Nota: En este momento, el servidor Vantage MCP solo está disponible como un servicio ejecutado localmente mediante el transporte de entrada/salida estándar (stdio) , lo que significa que debe ejecutarse en su máquina o servidor e integrarse con un cliente MCP.

Herramientas disponibles

El servidor Vantage MCP actualmente expone las siguientes herramientas, que pueden ser invocadas por cualquier cliente MCP compatible (por ejemplo, Claude, Cursor, Goose):

• query-costs
  • Una forma de propósito general para obtener datos de costos usando VQL.
• list-costs
  • Mostrar todos los costos en un informe de costos asociado.
• list-cost-reports
  • Enumere todos los informes de costos disponibles.
• get-cost-report-forecast
  • Enumere todos los pronósticos de gastos relacionados con un informe de costos.
• list-cost-integrations
  • Enumere todas las integraciones de proveedores de costos (por ejemplo, AWS, Azure, GCP) disponibles para proporcionar datos de costos y sus cuentas asociadas.
• list-cost-providers
  • Lista únicamente de los proveedores que el espacio de trabajo determinado ha compartido con él.
• list-cost-services
  • Enumera todos los servicios y sus proveedores asociados que se comparten con el espacio de trabajo determinado.
• list-budgets
  • Enumere todos los presupuestos disponibles para compararlos con un informe de costos y realizar un seguimiento del gasto.
• list-dashboards
  • Enumere todos los paneles creados en la cuenta Vantage.
• list-tags
  • Etiquetas de lista que se pueden usar para filtrar informes de costos.
• list-tag-values
  • Lista de valores de etiqueta que se pueden usar para filtrar informes de costos.
• list-anomalies
  • Enumere las anomalías que se detectaron en los informes de costos.
• list-cost-providers
  • Enumere los proveedores de costos que se pueden usar para filtrar costos en consultas VQL.
• list-unit-costs
  • Recupere los costos unitarios para un informe de costos determinado.
• get-myself
  • Una utilidad para enumerar los espacios de trabajo disponibles y verificar el nivel de acceso de su token de autenticación.
• submit-user-feedback
  • Una forma sencilla de enviar comentarios sobre el MCP o la experiencia general de Vantage al equipo de Vantage.

Empezando

Prerrequisitos

Si está instalando desde la fuente, asegúrese de que estén instalados los siguientes paquetes (consulte .tool-versions para ver las versiones exactas):

• Ir
• Node.js

Puede utilizar un administrador de versiones (por ejemplo, asdf ) o un administrador de paquetes (por ejemplo, Homebrew ) para instalar estas dependencias.

También deberá crear un token de API de Vantage de solo lectura (la escritura no funcionará por el momento). Siga las instrucciones de la documentación de la API de Vantage . Recomendamos crear un nuevo token de API de solo lectura para uso exclusivo con el servidor MCP.

Instalación

Usando Homebrew

De la fuente

1. Clonar este repositorio.

2. Construya el servidor y ajuste los permisos.

📝 Nota: Si extrae nuevos cambios del repositorio, asegúrese de volver a ejecutar go build para reconstruir el servidor y asegurarse de estar ejecutando la última versión.

3. Depurar utilizando el inspector MCP.

Configurar clientes MCP

Las instrucciones de configuración varían según el cliente MCP que utilice. Algunos ejemplos de clientes son:

• Claude para escritorio
• Cursor
• Ganso

Consulte la documentación de MCP para obtener una lista de los clientes disponibles. A continuación, se proporcionan instrucciones detalladas para Claude para Desktop, Cursor y Goose.

Claude para escritorio

1. Descargar Claude para escritorio .
2. Desde la parte superior de Claude for Desktop, haga clic en Claude > Configuración (atajo de teclado Command + , ).
3. En el menú izquierdo del panel Configuración, seleccione Desarrollador .
4. Haga clic en Editar configuración . Se creará un archivo de configuración en:

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• Ventanas : %APPDATA%\Claude\claude_desktop_config.json

5. Abra el archivo claude_desktop_config.json y actualice su contenido. Asegúrese de reemplazar los marcadores de posición <path_to_compiled_vantage_mcp_server_binary> con la ruta donde descargó el binario de Vantage MCP Server y <personal_vantage_api_token> con su token de API de Vantage.
   { "mcpServers": { "Vantage": { "command": "<path_to_compiled_vantage_mcp_server_binary>", "args": [], "env": { "VANTAGE_BEARER_TOKEN": "<personal_vantage_api_token>" } } } }
6. Guarde el archivo de configuración y reinicie Claude.
7. En la esquina inferior derecha del cuadro de entrada de Claude for Desktop, haga clic en el ícono del martillo para ver las herramientas disponibles para el servidor Vantage MCP.
8. Una vez configurada la herramienta, puede empezar a solicitarle permiso a Claude. Cada vez que use una nueva herramienta, Claude le solicitará su aprobación antes de continuar.

Cursor

1. Descargar Cursor .
2. Abra Cursor y haga clic en Cursor > Configuración > Configuración del cursor en la barra de menú.
3. En el panel izquierdo, seleccione MCP .
4. Haga clic en Agregar nuevo servidor MCP global .
5. Actualice el contenido del archivo mcp.json abierto. Asegúrese de reemplazar los marcadores de posición <path_to_compiled_vantage_mcp_server_binary> con la ruta donde descargó el binario de Vantage MCP Server y <personal_vantage_api_token> con su token de API de Vantage.
   { "mcpServers": { "Vantage": { "command": "<path_to_compiled_vantage_mcp_server_binary>", "args": [], "env": { "VANTAGE_BEARER_TOKEN": "<personal_vantage_api_token>" } } } }

Ganso

1. Descargar Goose .
2. Abra Goose y haga clic en Goose > Configuración en la barra de menú (atajo de teclado Command + , ).
3. En la sección Extensiones , haga clic en Agregar extensión personalizada .
4. En el campo ID , ingrese vantage-mcp-server .
5. En el campo Nombre , ingrese Vantage .
6. En el campo Descripción , ingrese Query costs and usage data .
7. En el campo Comando , ingrese la ruta al binario del servidor Vantage MCP.
8. En la sección Variables de entorno , agregue una nueva variable con el nombre VANTAGE_BEARER_TOKEN y el valor establecido en su token de API de Vantage.
9. Haga clic en Agregar .

Nota para usuarios de macOS

Si descarga una versión de nuestra página de Github y el ejecutable no se ejecuta porque no se puede verificar al desarrollador, abra la Configuración del sistema. Busque la sección "Privacidad y seguridad". Desplácese hasta el final y verá un mensaje que indica que "vantage-mcp-server-macos" está bloqueado. Haga clic en el botón "Abrir de todos modos". Después de este proceso, el ejecutable debería poder ejecutarse sin problemas.

Pautas de contribución

Si deseas contribuir a este proyecto:

1. Bifurcar este repositorio.
2. Crea una nueva rama: git checkout -b feature/my-feature .
3. Realice sus cambios.
4. Asegúrese de que su código esté formateado y se compile correctamente.
5. Enviar una solicitud de extracción .

Agradecemos las contribuciones de la comunidad, las mejoras y las correcciones de errores. Si encuentra algún problema, envíe un informe de errores a través de la sección "Errores de GitHub" de este repositorio.

Licencia

Consulte el archivo LICENSE.MD para obtener detalles sobre licencias comerciales y no comerciales.