{"_id":"@damenor/mcp-tools","name":"@damenor/mcp-tools","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@damenor/mcp-tools","version":"0.1.0","description":"MCP Tools para traducción y otras utilidades usando OpenRouter","type":"module","main":"dist/index.js","bin":{"mcp-ts":"dist/index.js"},"private":false,"scripts":{"build":"tsup","type-check":"tsc --noEmit","start":"node dist/index.js","start:cli":"cross-env NODE_ENV=cli node dist/index.js","start:http":"node dist/index.js","dev":"cross-env NODE_ENV=development tsup --watch","dev:cli":"cross-env NODE_ENV=development tsup --watch -- --stdio","lint":"eslint . --ext .ts","format":"prettier --write \"src/**/*.ts\"","inspect":"bunx @modelcontextprotocol/inspector","prepublishOnly":"npm run build","publish":"npm publish --access public"},"engines":{"node":">=18.0.0"},"keywords":["mcp","typescript","sdk","openrouter","translation","ai"],"author":{"name":"Damenor"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/damenor/mcp-ts.git"},"bugs":{"url":"https://github.com/damenor/mcp-ts/issues"},"homepage":"https://github.com/damenor/mcp-ts#readme","dependencies":{"@modelcontextprotocol/sdk":"^1.6.1","@types/yargs":"^17.0.33","cross-env":"^7.0.3","dotenv":"^16.4.7","express":"^4.21.2","remeda":"^2.20.1","yargs":"^17.7.2","zod":"^3.24.2"},"devDependencies":{"@types/express":"^5.0.0","@types/jest":"^29.5.11","@types/node":"^20.17.0","@typescript-eslint/eslint-plugin":"^8.24.0","@typescript-eslint/parser":"^8.24.0","eslint":"^9.20.1","eslint-config-prettier":"^10.0.1","jest":"^29.7.0","prettier":"^3.5.0","ts-jest":"^29.2.5","tsup":"^8.4.0","tsx":"^4.19.2","typescript":"^5.7.3"},"_id":"@damenor/mcp-tools@0.1.0","gitHead":"28bc1f1370caf698d3f27a849ce65eb572a8f521","types":"./dist/index.d.ts","_nodeVersion":"22.10.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-Rd21yK0ottXjdAsJqBZ1RjxVS00q2jlHhMJci2+MEo0NcXK67rxkoSYB3miTNWRBUSr87Bln9dGeYrWdedPThA==","shasum":"1dca69247f9372545bab9b3917a9c0c556e66467","tarball":"https://registry.npmjs.org/@damenor/mcp-tools/-/mcp-tools-0.1.0.tgz","fileCount":5,"unpackedSize":1125470,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCbO/4+J7bybpz23Q3z6qdMuoa2qQElykG6EQeO1tYIkAIgALEkY8jGSZQ6GI3cj+ElY931qm39/67RIWSO7EN5TDA="}]},"_npmUser":{"name":"damenor","email":"damenor.develop@gmail.com"},"directories":{},"maintainers":[{"name":"damenor","email":"damenor.develop@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-tools_0.1.0_1743045422390_0.2923449435626231"},"_hasShrinkwrap":false}},"time":{"created":"2025-03-27T03:17:02.288Z","0.1.0":"2025-03-27T03:17:02.712Z","modified":"2025-03-27T03:17:02.984Z"},"maintainers":[{"name":"damenor","email":"damenor.develop@gmail.com"}],"description":"MCP Tools para traducción y otras utilidades usando OpenRouter","homepage":"https://github.com/damenor/mcp-ts#readme","keywords":["mcp","typescript","sdk","openrouter","translation","ai"],"repository":{"type":"git","url":"git+https://github.com/damenor/mcp-ts.git"},"author":{"name":"Damenor"},"bugs":{"url":"https://github.com/damenor/mcp-ts/issues"},"license":"MIT","readme":"# MCP TypeScript Tools\r\n\r\n## Descripción\r\n\r\nEste 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.\r\n\r\n## Características\r\n\r\n- Servidor HTTP con soporte para SSE (Server-Sent Events)\r\n- Herramienta de traducción al inglés usando OpenRouter\r\n- Herramienta de saludo personalizado\r\n- Alto rendimiento y tipado fuerte con TypeScript\r\n- Validación de entrada con Zod\r\n\r\n## Requisitos Previos\r\n\r\n- Node.js >= 18.0.0\r\n- NPM o Yarn o Bun\r\n- Clave de API de OpenRouter\r\n\r\n## Instalación\r\n\r\n### Instalación Global (Recomendado)\r\n\r\n```bash\r\n# Instalar globalmente\r\nnpm install -g @damenor/mcp-tools\r\n\r\n# O con yarn\r\nyarn global add @damenor/mcp-tools\r\n\r\n# O con bun\r\nbun add -g @damenor/mcp-tools\r\n```\r\n\r\n### Instalación Local para Desarrollo\r\n\r\n```bash\r\n# Clonar el repositorio\r\ngit clone https://github.com/tu-usuario/mcp-ts.git\r\n\r\n# Instalar dependencias\r\nnpm install\r\n\r\n# Construir el proyecto\r\nnpm run build\r\n```\r\n\r\n## Configuración\r\n\r\n### Variables de Entorno\r\n\r\nCrea un archivo `.env` en la raíz del proyecto con:\r\n\r\n```env\r\nOPENROUTER_API_KEY=tu_clave_aqui\r\n```\r\n\r\n### Configuración para Herramientas MCP\r\n\r\nMuchas herramientas como Windsurf, Cline y [Claude Desktop](https://claude.ai/download) utilizan un archivo de configuración para iniciar el servidor.\r\n\r\nEl servidor `@damenor/mcp-tools` puede configurarse añadiendo lo siguiente a tu archivo de configuración:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"MCP Tools\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@damenor/mcp-tools\", \"--openrouter-api-key=<tu-api-key>\", \"--stdio\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Argumentos de Línea de Comandos\r\n\r\n- `--version`: Mostrar número de versión\r\n- `--stdio`: Ejecutar el servidor en modo comando (para herramientas MCP)\r\n- `--port`: Puerto para el servidor HTTP (por defecto: 3333)\r\n- `--openrouter-api-key`: Tu clave de API de OpenRouter (requerida)\r\n- `--help`: Mostrar menú de ayuda\r\n\r\n## Desarrollo\r\n\r\n```bash\r\n# Iniciar en modo desarrollo con hot reload\r\nnpm run dev\r\n\r\n# Compilar para producción\r\nnpm run build\r\n\r\n# Iniciar en producción\r\nnpm start\r\n\r\n# Iniciar en modo CLI\r\nnpm run start:cli\r\n\r\n# Iniciar en modo HTTP\r\nnpm run start:http\r\n```\r\n\r\n## Uso\r\n\r\n### Herramientas Disponibles\r\n\r\n#### Traductor al Inglés\r\n\r\n```typescript\r\n{\r\n  name: \"translate_to_english\",\r\n  params: {\r\n    text: string // Texto a traducir (máximo 1000 caracteres)\r\n  }\r\n}\r\n```\r\n\r\n#### Saludo\r\n\r\n```typescript\r\n{\r\n  name: \"greeting\",\r\n  params: {\r\n    name: string,\r\n    language?: 'en' | 'es',\r\n    formality?: 'formal' | 'informal'\r\n  }\r\n}\r\n```\r\n\r\n### Ejemplos de Uso\r\n\r\n```bash\r\n# Traducir texto\r\nmcp-ts translate_to_english \"Hola, ¿cómo estás?\"\r\n\r\n# Saludar\r\nmcp-ts greeting --name \"Juan\" --language \"es\" --formality \"informal\"\r\n```\r\n\r\n## Estructura del Proyecto\r\n\r\n```\r\nsrc/\r\n├── tools/              # Herramientas MCP\r\n│   ├── translate/      # Herramienta de traducción\r\n│   └── greeting/       # Herramienta de saludo\r\n├── utils/             # Utilidades\r\n├── constants/         # Constantes\r\n└── types/            # Definiciones de tipos\r\n```\r\n\r\n## Scripts Disponibles\r\n\r\n- `npm run build` - Compilar el proyecto\r\n- `npm run dev` - Iniciar en modo desarrollo\r\n- `npm run start` - Iniciar en producción\r\n- `npm run lint` - Ejecutar linter\r\n- `npm run format` - Formatear código\r\n- `npm run type-check` - Verificar tipos\r\n- `npm run inspect` - Inspeccionar respuestas MCP\r\n\r\n## Rendimiento\r\n\r\nEste proyecto está optimizado para:\r\n\r\n- Respuestas rápidas\r\n- Validación eficiente\r\n- Manejo de errores robusto\r\n- Tipado fuerte con TypeScript\r\n- Modularidad y extensibilidad\r\n\r\n## Licencia\r\n\r\nMIT\r\n","readmeFilename":"README.md","_rev":"1-4cc29ba90fc6cdc5290134080b830bf0"}