# Violett MCP Server

Servidor MCP (Model Context Protocol) completo basado en el ejemplo de `simpleStreamableHttp.ts` del [typescript-sdk oficial](https://github.com/modelcontextprotocol/typescript-sdk).

## Características

Este servidor MCP incluye:

### 🔧 Herramientas (Tools)
- **fetch_url**: Realiza peticiones HTTP GET para obtener contenido de URLs
- **post_data**: Envía datos mediante peticiones HTTP POST

### 💡 Prompts
- **summarize_url**: Genera un resumen del contenido de una URL
- **analyze_api**: Analiza la estructura de respuesta de una API

### 📊 Recursos (Resources)
- **stream://example**: Recurso de ejemplo con streaming de datos
- **http(s)://...**: Soporte para recursos HTTP dinámicos

## Instalación

```bash
npm install
```

## Compilación

```bash
npm run build
```

## Uso

### Modo desarrollo (TypeScript directo)
```bash
npm run dev
# o específicamente para MCP:
npm run mcp
```

### Modo producción (JavaScript compilado)
```bash
npm start
```

## Integración con Clientes MCP

Para usar este servidor desde un cliente MCP, puedes usar la configuración incluida en `mcp-config.json`:

```json
{
  "mcpServers": {
    "violett-mcp-server": {
      "command": "npx",
      "args": ["-y", "ts-node", "src/examples/single-node-server.ts"],
      "cwd": ".",
      "env": {}
    }
  }
}
```

## Ejemplo de uso

Una vez conectado, el servidor proporciona herramientas para:

1. **Obtener contenido web**:
   - Usar la herramienta `fetch_url` con parámetro `url`
   
2. **Enviar datos a APIs**:
   - Usar la herramienta `post_data` con parámetros `url` y `data`

3. **Generar prompts inteligentes**:
   - `summarize_url`: Para resumir contenido de una URL
   - `analyze_api`: Para analizar respuestas de API

## Estructura del proyecto

```
violett-mcp-server/
├── src/
│   └── examples/
│       └── single-node-server.ts    # Servidor MCP principal
├── dist/                            # JavaScript compilado
├── mcp-config.json                  # Configuración para clientes MCP
├── package.json
└── README.md
```

## Desarrollo basado en el SDK oficial

Este servidor está basado en el ejemplo `simpleStreamableHttp.ts` del [Model Context Protocol TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk/blob/main/src/examples/server/simpleStreamableHttp.ts).

Para más información sobre MCP, consulta la [documentación oficial](https://github.com/modelcontextprotocol/typescript-sdk?tab=readme-ov-file#quick-start).