Iris MCPサーバー

Google Driveの書き込みアクセス、Notionなどを単一のMCPコネクタ経由で提供するマルチバックエンドMCPゲートウェイ。

概要

Irisは、ユーザーが1つのカスタムコネクタ（Iris）を接続するだけで、複数のバックエンドサービスへの完全な読み書き機能にアクセスできるようにすることで、無料枠のMCPコネクタの制限を解決します。

2つのモード:

• 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 Drive APIが有効なGoogle Cloudプロジェクト

• OAuth 2.0認証情報 (クライアントIDおよびシークレット)

セットアップ

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用)

ブラウザベースのclaude.aiでIrisを使用するには:

# 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. クライアントIDとクライアントシークレットを .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)

開発

ウォッチモード:

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) 目的: マルチインスタンスAIシステムおよびニューロダイバージェントなAIコラボレーションのため

サポート

• イシュー: https://github.com/continuity-bridge/iris-mcp-server/issues

• ドキュメント: https://uncletallest.productions/iris-mcp-server/docs