luis0794/violett-mcp-server

Violett MCP Server

Servidor MCP (Model Context Protocol) completo basado en el ejemplo de simpleStreamableHttp.ts del typescript-sdk oficial.

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

npm install

Compilación

npm run build

Uso

Modo desarrollo (TypeScript directo)

npm run dev
# o específicamente para MCP:
npm run mcp

Modo producción (JavaScript compilado)

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:

{
  "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.

Para más información sobre MCP, consulta la documentación oficial.