Nexus-MCP

Un kit de herramientas integral del Protocolo de Contexto de Modelo para asistentes de IA

Transforma cualquier asistente de IA en un agente autónomo capaz de ejecutar tareas del mundo real.

Documentación • Primeros pasos • Hoja de ruta • Arquitectura

🎯 Descripción general

Nexus-MCP es un potente servidor del Protocolo de Contexto de Modelo (MCP) construido con TypeScript/Node.js que proporciona a los modelos de IA herramientas universales para:

• 📁 Operaciones del sistema de archivos - Leer, escribir, buscar y monitorear archivos

• 🌐 Solicitudes HTTP/Web - Obtener datos, extraer información de sitios web, llamar a APIs

• 🔄 Flujos de trabajo de Git - Clonar, confirmar (commit), crear ramas y gestionar repositorios

• 🗄️ Consultas de bases de datos - Consultar bases de datos SQL y NoSQL

• 💻 Comandos del sistema - Ejecutar comandos de shell y gestionar procesos

• 🤖 Integración de IA - Chatear con LLMs, crear incrustaciones (embeddings), procesar texto

• 🔧 Utilidades - Análisis de JSON/YAML, compresión, cifrado y más

🚀 Inicio rápido

Instalación

npm install -g @nexus-mcp/server

Configuración

# Copy example environment file
cp .env.example .env

# Edit with your settings
nano .env

Ejecución

nexus-mcp

Integración con Claude Code

Añadir a la configuración de Claude Desktop:

{
  "mcpServers": {
    "nexus-mcp": {
      "command": "node",
      "args": ["/path/to/nexus-mcp/dist/index.js"]
    }
  }
}

📦 Características

Herramientas de sistema de archivos

• nexus_read_file - Leer archivos con soporte de codificación

• nexus_write_file - Escribir/crear archivos

• nexus_list_directory - Listar el contenido de directorios

• nexus_search_files - Buscar archivos por patrón

• nexus_search_content - Buscar contenido dentro de archivos

• nexus_watch_directory - Monitorear cambios en directorios

Herramientas HTTP

• nexus_http_get - Solicitudes HTTP GET

• nexus_http_post - Solicitudes HTTP POST

• nexus_fetch_url - Obtener y analizar contenido web

• nexus_parse_html - Analizar HTML con Cheerio

• nexus_call_api - Llamadas genéricas a API

Herramientas de Git

• nexus_git_clone - Clonar repositorios

• nexus_git_commit - Crear confirmaciones (commits)

• nexus_git_push - Enviar a remoto

• nexus_git_pr_create - Crear solicitudes de extracción (pull requests)

• Integración con GitHub, GitLab, Bitbucket

Herramientas de base de datos

• nexus_db_query - Ejecutar consultas SQL

• nexus_db_list_tables - Listar tablas de base de datos

• nexus_db_describe_table - Describir el esquema de la tabla

• Soporte para PostgreSQL, MySQL, SQLite, SQL Server, MongoDB

Herramientas del sistema

• nexus_exec_command - Ejecutar comandos de shell

• nexus_system_info - Obtener información del sistema

• nexus_process_list - Listar procesos en ejecución

• nexus_service_start/stop - Gestionar servicios

Herramientas de IA

• nexus_llm_chat - Chatear con LLMs (Anthropic, OpenAI)

• nexus_embedding_create - Crear incrustaciones de texto

• nexus_text_summarize - Resumir texto

• nexus_code_generate - Generar código

Herramientas de utilidades

• nexus_json_parse/stringify - Manipulación de JSON

• nexus_yaml_parse/stringify - Manipulación de YAML

• nexus_zip_create/extract - Compresión ZIP

• nexus_encrypt/decrypt - Cifrado/descifrado

🏗️ Arquitectura

┌─────────────────────────────────────────┐
│         Claude / LLM Client              │
└──────────────┬──────────────────────────┘
               │ MCP Protocol (stdio)
               ▼
┌─────────────────────────────────────────┐
│           Nexus-MCP Server               │
│  ┌───────────────────────────────────┐  │
│  │      MCP Server Core             │  │
│  └───────────────────────────────────┘  │
│         ┌───────┴───────┐                │
│         │               │                │
│    ┌────▼────┐    ┌────▼────┐           │
│    │ Filesys │    │   HTTP  │           │
│    └─────────┘    └─────────┘           │
│    ┌─────────┐    ┌─────────┐           │
│    │   Git   │    │ Database│           │
│    └─────────┘    └─────────┘           │
│    ┌─────────┐    ┌─────────┐           │
│    │  System │    │    AI   │           │
│    └─────────┘    └─────────┘           │
└─────────────────────────────────────────┘

Para obtener información detallada sobre la arquitectura, consulte docs/architecture.md

🏛️ Calidad de nivel de producción

Nexus-MCP está construido pensando en la excelencia arquitectónica, diseñado para su uso en producción y adopción por parte de la comunidad. Seguimos principios estrictos:

• ✅ Seguridad de tipos: Modo estricto de TypeScript + validación con Zod

• ✅ Manejo de errores: Mensajes de error estructurados y procesables

• ✅ Rendimiento: Operaciones asíncronas, almacenamiento en caché, streaming

• ✅ Seguridad: Validación de entradas, saneamiento, registros de auditoría

• ✅ Observabilidad: Registro estructurado, métricas, rastreo

• ✅ Capacidad de prueba: Cobertura superior al 80%, inyección de dependencias

• ✅ Documentación: JSDoc, ejemplos, guías completas

• ✅ Experiencia del desarrollador: Errores claros, soporte para IDE, retroalimentación rápida

Consulte Principios arquitectónicos para obtener todos los detalles.

📚 Documentación

• Guía de primeros pasos - Inicio rápido y uso básico

• Documentación de arquitectura - Arquitectura y diseño del sistema

• Principios arquitectónicos - Principios de diseño y mejores prácticas

• Referencia de API - Documentación completa de la API

• Referencia de herramientas - Documentación detallada de las herramientas

• Hoja de ruta - Hoja de ruta de desarrollo y progreso

🛠️ Desarrollo

# Clone repository
git clone https://github.com/your-org/Nexus-MCP.git
cd Nexus-MCP

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Build for production
npm run build

# Lint code
npm run lint

📊 Estado del proyecto

• Versión actual: 1.0.0-alpha

• Estado de desarrollo: Planificación y diseño

• Progreso del núcleo: 0%

• Herramientas objetivo: 50+

• Objetivo de cobertura de pruebas: 80%+

Consulte ROADMAP.md para ver el progreso detallado.

🤝 Contribución

¡Las contribuciones son bienvenidas! Por favor, lea nuestras directrices de contribución antes de enviar PRs.

1. Bifurque (fork) el repositorio

2. Cree su rama de características (git checkout -b feature/amazing-feature)

3. Confirme sus cambios (git commit -m 'Add amazing feature')

4. Envíe a la rama (git push origin feature/amazing-feature)

5. Abra una solicitud de extracción (Pull Request)

📄 Licencia

Este proyecto está bajo la Licencia MIT - consulte el archivo LICENSE para obtener más detalles.

🙏 Agradecimientos

• Model Context Protocol

• Anthropic Claude

• MCP SDK TypeScript

📞 Soporte

• 📖 Documentación

• 🐛 Rastreador de problemas

• 💬 Comunidad de Discord

• ✉️ Correo electrónico: support@nexus-mcp.dev

Creado con ❤️ por el equipo de Nexus