# SyV MCP Tools

Servidor MCP (Model Context Protocol) del proyecto [Subordinación y Valor](https://github.com/kodexArg/syv).

## Descripción

Este servidor MCP proporciona herramientas para trabajar con los metadatos de archivos Markdown del proyecto SyV. Permite validar y obtener metadatos según las especificaciones definidas en la guía de metadatos del proyecto.

## Herramientas Disponibles

### `validar_metadatos_markdown`
Valida los metadatos de archivos `*.md` contra las especificaciones en `0_proyecto/guias-para-colaboradores/guia-de-metadatos.md`.

**Parámetros:**
- `ruta_archivo` (str): Ruta al archivo Markdown a validar

**Retorna:** JSON con:
- `status` (bool): `False` si la validación falló, `True` si pasó
- `message` (str): Descripción del error (usar solo si status es False)

### `obtener_metadatos_markdown`
Recupera los metadatos de archivos Markdown.

**Parámetros:**
- `ruta_archivo` (str): Ruta al archivo Markdown

**Retorna:** JSON con los campos de metadatos o error

## Instalación

Requiere Python >=3.12

```bash
# Instalar dependencias
uv sync
```

## Configuración

Crear un archivo `.env` en la raíz del proyecto con:

```
ANTHROPIC_API_KEY=tu_api_key_aquí
```

## Uso

```bash
# Ejecutar el servidor MCP
python mcp_server.py
```

O usando el script batch (Windows):

```bash
mcp_server.bat
```

## Dependencias Principales

- `mcp`: Framework para servidores MCP
- `pydantic`: Validación de datos
- `anthropic`: Cliente para API de Claude
- `python-dotenv`: Gestión de variables de entorno

## Proyecto Principal

Este servidor es parte del proyecto [Subordinación y Valor](https://github.com/kodexArg/syv), un proyecto de investigación y documentación sobre subordinación y generación de valor.