IRIS ObjectScript MCP Server

Model Context Protocol (MCP) server para documentación de IRIS ObjectScript. Proporciona acceso a documentación, ejemplos y herramientas de búsqueda para el desarrollo con InterSystems IRIS.

🚀 Inicio Rápido

Desarrollo Local

Deployment con Docker

📁 Estructura del Proyecto

🛠️ Herramientas MCP Disponibles

1. smart_search - Búsqueda inteligente con descarga automática

   • Busca primero en caché local

   • Descarga documentos relevantes si es necesario

   • Mapeo inteligente de términos a KEYs

2. search_objectscript - Búsqueda rápida solo en caché local

   • Búsqueda instantánea en documentos descargados

   • Resultados con contexto y números de línea

3. open_by_key - Abrir documentación por KEY oficial

   • Acceso directo a documentación específica

   • Descarga y cachea automáticamente

4. open_class - Abrir documentación de clase

   • Documatic para clases (ej. %Library.String)

   • Navegación por jerarquía de clases

🐳 Docker Deployment

Para deployment en producción, usa Docker:

Scripts de Gestión (en deploy/)

• docker-manage.sh - Script principal de gestión

• setup-volumes.sh - Configuración de volúmenes bidireccionales

• iris-mcp-wrapper.sh - Wrapper para usar en mcp.json

Comandos Principales

📋 Configuración en mcp.json

Ubicación del archivo:

• macOS: ~/Library/Application Support/Claude/mcp.json

• Windows: %APPDATA%\\Claude\\mcp.json

• Linux: ~/.config/claude/mcp.json

🔧 Desarrollo

Scripts NPM

Estructura de Código

• server.ts - Punto de entrada del servidor MCP

• tools/ - Definiciones de herramientas MCP

• search/ - Lógica de búsqueda (local y inteligente)

• loaders/ - Descarga y procesamiento de documentación

• resources/ - Recursos y templates MCP

📊 Volúmenes y Persistencia

Configuración Bidireccional

• data/ ↔ Contenedor - Sincronización completa

• logs/ ↔ Contenedor - Logs compartidos

Casos de Uso

• ✅ Modificas archivos localmente → Se reflejan en el contenedor

• ✅ El MCP descarga docs → Aparecen en tu data/cache/

• ✅ Backup/sync de data/ funciona normalmente

🚦 Estados y Flujos

Primera Instalación

1. cd deploy/

2. ./docker-manage.sh build

3. ./docker-manage.sh start

4. ./setup-volumes.sh

5. Configurar mcp.json

Desarrollo Diario

1. ./docker-manage.sh status (verificar)

2. Trabajar normalmente en el código

3. ./docker-manage.sh restart (si cambias código)

Actualización

1. git pull

2. cd deploy/

3. ./docker-manage.sh stop

4. ./docker-manage.sh build

5. ./docker-manage.sh start

🔍 Ejemplo de Uso

📖 Documentación Adicional

• DOCKER.md - Documentación completa de Docker, scripts y troubleshooting

• Logs: Revisar logs/ o ./docker-manage.sh logs

• Cache: Explorar data/cache/ para ver documentos descargados

🛡️ Seguridad

• Contenedor ejecuta con usuario no-root

• Sin puertos expuestos (MCP usa stdio)

• Volúmenes con permisos mínimos necesarios

• Imágenes basadas en Alpine Linux

🔧 Troubleshooting

Para documentación detallada de Docker y deployment, consulta deploy/DOCKER.md.