MCP TypeScript Tools

Descripción

Este es un servidor MCP (Model Context Protocol) implementado en TypeScript que proporciona herramientas para interactuar con LLMs, incluyendo traducción de texto y otras utilidades.

Características

• Servidor HTTP con soporte para SSE (Server-Sent Events)
• Herramienta de traducción al inglés usando OpenRouter
• Herramienta de saludo personalizado
• Alto rendimiento y tipado fuerte con TypeScript
• Validación de entrada con Zod

Requisitos Previos

• Node.js >= 18.0.0
• NPM o Yarn o Bun
• Clave de API de OpenRouter

Instalación

Instalación Global (Recomendado)

# Instalar globalmente
npm install -g @damenor/mcp-tools

# O con yarn
yarn global add @damenor/mcp-tools

# O con bun
bun add -g @damenor/mcp-tools

Instalación Local para Desarrollo

# Clonar el repositorio
git clone https://github.com/tu-usuario/mcp-ts.git

# Instalar dependencias
npm install

# Construir el proyecto
npm run build

Configuración

Variables de Entorno

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

OPENROUTER_API_KEY=tu_clave_aqui

Configuración para Herramientas MCP

Muchas herramientas como Windsurf, Cline y Claude Desktop utilizan un archivo de configuración para iniciar el servidor.

El servidor @damenor/mcp-tools puede configurarse añadiendo lo siguiente a tu archivo de configuración:

{
  "mcpServers": {
    "MCP Tools": {
      "command": "npx",
      "args": ["-y", "@damenor/mcp-tools", "--openrouter-api-key=<tu-api-key>", "--stdio"]
    }
  }
}

Argumentos de Línea de Comandos

• --version: Mostrar número de versión
• --stdio: Ejecutar el servidor en modo comando (para herramientas MCP)
• --port: Puerto para el servidor HTTP (por defecto: 3333)
• --openrouter-api-key: Tu clave de API de OpenRouter (requerida)
• --help: Mostrar menú de ayuda

Desarrollo

# Iniciar en modo desarrollo con hot reload
npm run dev

# Compilar para producción
npm run build

# Iniciar en producción
npm start

# Iniciar en modo CLI
npm run start:cli

# Iniciar en modo HTTP
npm run start:http

Uso

Herramientas Disponibles

Traductor al Inglés

{
  name: "translate_to_english",
  params: {
    text: string // Texto a traducir (máximo 1000 caracteres)
  }
}

Saludo

{
  name: "greeting",
  params: {
    name: string,
    language?: 'en' | 'es',
    formality?: 'formal' | 'informal'
  }
}

Ejemplos de Uso

# Traducir texto
mcp-ts translate_to_english "Hola, ¿cómo estás?"

# Saludar
mcp-ts greeting --name "Juan" --language "es" --formality "informal"

Estructura del Proyecto

src/
├── tools/              # Herramientas MCP
│   ├── translate/      # Herramienta de traducción
│   └── greeting/       # Herramienta de saludo
├── utils/             # Utilidades
├── constants/         # Constantes
└── types/            # Definiciones de tipos

Scripts Disponibles

• npm run build - Compilar el proyecto
• npm run dev - Iniciar en modo desarrollo
• npm run start - Iniciar en producción
• npm run lint - Ejecutar linter
• npm run format - Formatear código
• npm run type-check - Verificar tipos
• npm run inspect - Inspeccionar respuestas MCP

Rendimiento

Este proyecto está optimizado para:

• Respuestas rápidas
• Validación eficiente
• Manejo de errores robusto
• Tipado fuerte con TypeScript
• Modularidad y extensibilidad

Licencia

MIT