README.txt•2.7 kB
# VGL CV Data MCP
Un servidor MCP (Model Context Protocol) que proporciona acceso a los datos del curriculum vitae de Valentin Gonzalez Loureiro.
## Descripción
Este MCP permite a los clientes MCP obtener información del CV de Valentin Gonzalez Loureiro a través de una API REST. El servidor expone una herramienta que hace una petición HTTP a `https://vgl.com.ar/api/cv.json` y devuelve los datos del CV en formato JSON.
## Características
- **Herramienta única**: `fetch-vgl-cv` - Obtiene los datos del CV
- **Protocolo**: MCP (Model Context Protocol) v1.13.3
- **Transporte**: STDIO (Standard Input/Output)
- **Validación**: Utiliza Zod para validación de esquemas
## Instalación
1. Clona este repositorio:
```bash
git clone <url-del-repositorio>
cd vgl
```
2. Instala las dependencias:
```bash
npm install
```
## Uso
### Ejecución directa
```bash
npx -y @modelcontextprotocol/inspector npx -y tsx main.ts
```
### Como servidor MCP
Este servidor puede ser utilizado por cualquier cliente MCP compatible. Para configurarlo en tu cliente MCP, agrega la siguiente configuración:
```json
{
"mcpServers": {
"vgl-cv-data": {
"command": "node",
"args": ["main.ts"],
"cwd": "/ruta/a/este/proyecto"
}
}
}
```
## API
### Herramienta: `fetch-vgl-cv`
**Descripción**: Obtiene los datos del curriculum vitae de Valentin Gonzalez Loureiro.
**Parámetros**:
- `CV` (string): Curriculum vitae (requerido)
**Respuesta**:
```json
{
"content": [
{
"type": "text",
"text": "{\"datos\": \"del CV en formato JSON\"}"
}
]
}
```
## Dependencias
- `@modelcontextprotocol/sdk`: ^1.13.3 - SDK oficial de MCP
- `zod`: ^3.25.69 - Biblioteca de validación de esquemas
## Estructura del Proyecto
```
vgl/
├── main.ts # Archivo principal del servidor MCP
├── package.json # Configuración del proyecto y dependencias
├── package-lock.json # Lock file de dependencias
└── README.md # Este archivo
```
## Desarrollo
### Requisitos
- Node.js (versión 18 o superior)
- npm
### Scripts disponibles
```bash
npm test # Ejecuta las pruebas (actualmente no implementado)
```
## Licencia
ISC
## Autor
Valentin Gonzalez Loureiro
## Contribución
Las contribuciones son bienvenidas. Por favor, abre un issue o un pull request para sugerir mejoras o reportar problemas.
## Notas
- Este MCP requiere conexión a internet para obtener los datos del CV
- La API externa (`https://vgl.com.ar/api/cv.json`) debe estar disponible para que el servidor funcione correctamente
- El servidor utiliza transporte STDIO, lo que significa que se comunica a través de la entrada y salida estándar