Servidor MCP Iris

Pasarela MCP multi-backend que proporciona acceso de escritura a Google Drive, Notion y más a través de un único conector MCP.

Descripción general

Iris resuelve la limitación del nivel gratuito de los conectores MCP actuando como una pasarela: los usuarios conectan UN conector personalizado (Iris) y obtienen acceso a múltiples servicios backend con capacidades completas de lectura/escritura.

Dos modos:

• Modo Stdio (Claude Desktop) - Listo para producción ✅

• Modo HTTP (Navegador claude.ai) - Prototipo 🧪 Ver HTTP-MODE-GUIDE.md

Lo que ofrece Iris

Backend de Google Drive:

• ✅ iris_drive_write - Crear o actualizar archivos

• ✅ iris_drive_read - Leer el contenido de archivos

• ✅ iris_drive_create_folder - Crear estructuras de carpetas

• ✅ iris_drive_list - Listar archivos y carpetas

• ✅ iris_drive_move - Mover o renombrar archivos

• ✅ iris_drive_delete - Eliminar archivos (con confirmación de seguridad)

Próximamente:

• Backend de Notion (lectura + escritura)

• Backend de Slack (enviar mensajes)

• Backend de Dropbox (lectura + escritura)

Instalación

Requisitos previos

• Node.js 18+ y npm

• Proyecto de Google Cloud con la API de Drive habilitada

• Credenciales de OAuth 2.0 (ID de cliente y secreto)

Configuración

1. Clonar e instalar dependencias:

git clone https://github.com/continuity-bridge/iris-mcp-server.git
cd iris-mcp-server
npm install

2. Configurar el entorno:

cp .env.example .env
# Edit .env with your Google OAuth credentials

3. Compilar:

npm run build

4. Probar localmente:

npx @modelcontextprotocol/inspector node dist/index.js

Configuración del modo HTTP (Para el navegador Claude.ai)

Para usar Iris con claude.ai basado en navegador:

# After completing OAuth setup above
npm run setup:browser  # Interactive wizard
npm run http           # Start HTTP server

Consulte HTTP-MODE-GUIDE.md para obtener la guía completa de integración en el navegador.

Configuración

Configuración de Google OAuth

1. Vaya a Google Cloud Console

2. Cree un nuevo proyecto o seleccione uno existente

3. Habilite la API de Google Drive

4. Cree credenciales de OAuth 2.0:

   • Tipo de aplicación: Aplicación web

   • URIs de redireccionamiento autorizados: https://iris.uncletallest.productions/oauth/callback

5. Copie el ID de cliente y el secreto de cliente en .env

Variables de entorno

Consulte .env.example para ver toda la configuración requerida.

Uso

Integración del sistema multi-instancia (Caso de uso de ejemplo)

La instancia de coordinación guarda notas compartidas:

iris_drive_write({
  path: "coordination/shared-notes.md",
  content: "Instance A is handling task X, Instance B is tracking Y...",
  mode: "upsert"
})

La instancia de seguimiento de salud guarda datos de bienestar:

iris_drive_write({
  path: "wellness/tracking/2026-03.md",
  content: "# March 2026 Health Log\n\n## Week 1\n- Energy: 7/10\n- Sleep: 8hrs avg\n...",
  mimeType: "text/markdown"
})

La instancia de seguimiento de proyectos guarda datos de la aplicación:

iris_drive_write({
  path: "projects/applications/applied-march.md",
  content: "| Company | Position | Applied | Status |\n|---------|----------|---------|--------|\n...",
  mode: "upsert"
})

Ejemplos de herramientas

Crear estructura de carpetas:

iris_drive_create_folder({
  path: "projects/active/project-alpha"
})
// Creates: projects/ → projects/active/ → projects/active/project-alpha/

Listar archivos:

iris_drive_list({
  path: "coordination",
  recursive: false,
  type: "both"
})

Leer archivo:

iris_drive_read({
  path: "coordination/memory.md",
  asText: true
})

Mover archivo:

iris_drive_move({
  sourcePath: "old-location/file.md",
  destinationPath: "new-location/file.md"
})

Eliminar archivo (con confirmación):

iris_drive_delete({
  path: "temp/old-notes.md",
  confirm: true,
  permanent: false  // Moves to trash, not permanent
})

Arquitectura

Claude.ai User (Free Tier)
  ↓
  (1 Custom Connector Slot)
  ↓
Iris MCP Server
  ↓
  Google Drive API (via OAuth)
  Notion API (future)
  Slack API (future)

Desarrollo

Modo de observación (watch):

npm run dev

Compilar:

npm run build

Probar con el Inspector MCP:

npx @modelcontextprotocol/inspector node dist/index.js

Hoja de ruta

• [x] Backend de escritura de Google Drive

• [x] Panel de OAuth para la autenticación de usuarios

• [x] Cifrado de tokens y almacenamiento en base de datos

• [ ] Backend de Notion

• [ ] Backend de Slack

• [ ] Backend de Dropbox

• [ ] Panel de gestión de usuarios

• [ ] Listado en el mercado de servidores MCP

Contribución

¡Las solicitudes de extracción (pull requests) son bienvenidas! Por favor, lea primero CONTRIBUTING.md.

Licencia

Licencia MIT - consulte el archivo LICENSE para obtener más detalles

Créditos

Creado por: Jerry Jackson (Uncle Tallest) Para: Sistemas de IA multi-instancia y colaboración IA-neurodivergente

Soporte

• Problemas: https://github.com/continuity-bridge/iris-mcp-server/issues

• Documentación: https://uncletallest.productions/iris-mcp-server/docs