Iris MCP Server

Мультибэкенд-шлюз MCP, предоставляющий доступ к записи в Google Drive, Notion и другим сервисам через единый коннектор MCP.

Обзор

Iris решает проблему ограничения бесплатных коннекторов MCP, выступая в качестве шлюза: пользователи подключают ОДИН пользовательский коннектор (Iris) и получают доступ к нескольким бэкенд-сервисам с полными возможностями чтения/записи.

Два режима:

• Режим Stdio (Claude Desktop) - готов к использованию в продакшене ✅

• Режим HTTP (браузер claude.ai) - прототип 🧪 См. HTTP-MODE-GUIDE.md

Что предоставляет Iris

Бэкенд Google Drive:

• ✅ iris_drive_write - создание или обновление файлов

• ✅ iris_drive_read - чтение содержимого файлов

• ✅ iris_drive_create_folder - создание структуры папок

• ✅ iris_drive_list - список файлов и папок

• ✅ iris_drive_move - перемещение или переименование файлов

• ✅ iris_drive_delete - удаление файлов (с подтверждением безопасности)

Скоро появится:

• Бэкенд Notion (чтение + запись)

• Бэкенд Slack (отправка сообщений)

• Бэкенд Dropbox (чтение + запись)

Установка

Предварительные требования

• Node.js 18+ и npm

• Проект в Google Cloud с включенным Drive API

• Учетные данные OAuth 2.0 (Client ID и Secret)

Настройка

1. Клонируйте репозиторий и установите зависимости:

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

2. Настройте окружение:

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

3. Сборка:

npm run build

4. Локальное тестирование:

npx @modelcontextprotocol/inspector node dist/index.js

Настройка режима HTTP (для браузерной версии Claude.ai)

Чтобы использовать Iris с браузерной версией claude.ai:

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

См. HTTP-MODE-GUIDE.md для получения полного руководства по интеграции с браузером.

Конфигурация

Настройка Google OAuth

1. Перейдите в Google Cloud Console

2. Создайте новый проект или выберите существующий

3. Включите Google Drive API

4. Создайте учетные данные OAuth 2.0:

   • Тип приложения: Веб-приложение

   • Авторизованные URI перенаправления: https://iris.uncletallest.productions/oauth/callback

5. Скопируйте Client ID и Client Secret в файл .env

Переменные окружения

См. .env.example для получения информации обо всех необходимых настройках.

Использование

Интеграция с мультиэкземплярной системой (пример использования)

Экземпляр координации сохраняет общие заметки:

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

Экземпляр отслеживания здоровья сохраняет данные о самочувствии:

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"
})

Экземпляр отслеживания проектов сохраняет данные приложения:

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

Примеры инструментов

Создание структуры папок:

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

Список файлов:

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

Чтение файла:

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

Перемещение файла:

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

Удаление файла (с подтверждением):

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

Архитектура

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

Разработка

Режим отслеживания (watch mode):

npm run dev

Сборка:

npm run build

Тестирование с помощью MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Дорожная карта

• [x] Бэкенд записи Google Drive

• [x] Панель управления OAuth для аутентификации пользователей

• [x] Шифрование токенов и хранение в базе данных

• [ ] Бэкенд Notion

• [ ] Бэкенд Slack

• [ ] Бэкенд Dropbox

• [ ] Панель управления пользователями

• [ ] Размещение в маркетплейсе серверов MCP

Участие в разработке

Пул-реквесты приветствуются! Пожалуйста, сначала прочитайте CONTRIBUTING.md.

Лицензия

Лицензия MIT - подробности см. в файле LICENSE

Авторы

Создатель: Jerry Jackson (Uncle Tallest)
Для: Мультиэкземплярных систем ИИ и нейродивергентного сотрудничества с ИИ

Поддержка

• Проблемы: https://github.com/continuity-bridge/iris-mcp-server/issues

• Документация: https://uncletallest.productions/iris-mcp-server/docs