AI导哈

多后端MCP网关

Iris是一款多后端MCP网关，让AI助手通过单一MCP连接器即可读写Google Drive（未来支持Notion、Slack等），解决免费版自定义连接器数量受限的问题。

  • by reclamation-bridge
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 continuity-bridge/iris-mcp-server

使用说明

author: Vector (Dom1) copyright: © 2026 Jerry Jackson. All rights reserved. version: v0.2.0 created: 2026-03-28 last_updated: 2026-03-28 status: active catalog_priority: medium catalog_desc: Iris MCP server README. Multi-backend gateway providing Google Drive write access, Notion, and more through a single MCP connector.

Iris MCP Server

Multi-backend MCP gateway providing Google Drive write access, Notion, and more through a single MCP connector.

Overview

Iris solves the free-tier MCP connector limitation by acting as a gateway: users connect ONE custom connector (Iris) and get access to multiple backend services with full read/write capabilities.

Two Modes:

  • Stdio Mode (Claude Desktop) - Production ready ✅
  • HTTP Mode (Browser claude.ai) - Prototype 🧪 See HTTP-MODE-GUIDE.md

What Iris Provides

Google Drive Backend:

  • ✅ iris_drive_write - Create or update files
  • ✅ iris_drive_read - Read file contents
  • ✅ iris_drive_create_folder - Create folder structures
  • ✅ iris_drive_list - List files and folders
  • ✅ iris_drive_move - Move or rename files
  • ✅ iris_drive_delete - Delete files (with safety confirmation)

Coming Soon:

  • Notion backend (read + write)
  • Slack backend (send messages)
  • Dropbox backend (read + write)

Installation

Prerequisites

  • Node.js 18+ and npm
  • Google Cloud Project with Drive API enabled
  • OAuth 2.0 credentials (Client ID and Secret)

Setup

  1. Clone and install dependencies:
git clone https://github.com/continuity-bridge/iris-mcp-server.git
cd iris-mcp-server
npm install
  1. Configure environment:
cp .env.example .env
# Edit .env with your Google OAuth credentials
  1. Build:
npm run build
  1. Test locally:
npx @modelcontextprotocol/inspector node dist/index.js

HTTP Mode Setup (For Browser Claude.ai)

To use Iris with browser-based claude.ai:

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

See HTTP-MODE-GUIDE.md for complete browser integration guide.

Configuration

Google OAuth Setup

  1. Go to Google Cloud Console
  2. Create a new project or select existing
  3. Enable Google Drive API
  4. Create OAuth 2.0 credentials:
    • Application type: Web application
    • Authorized redirect URIs: https://iris.uncletallest.productions/oauth/callback
  5. Copy Client ID and Client Secret to .env

Environment Variables

See .env.example for all required configuration.

Usage

Multi-Instance System Integration (Example Use Case)

Coordinating instance saves shared notes:

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

Health tracking instance saves wellness data:

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

Project tracking instance saves application data:

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

Tool Examples

Create folder structure:

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

List files:

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

Read file:

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

Move file:

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

Delete file (with confirmation):

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

Architecture

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

Development

Watch mode:

npm run dev

Build:

npm run build

Test with MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Roadmap

  • [x] Google Drive write backend
  • [x] OAuth dashboard for user authentication
  • [x] Token encryption and database storage
  • [ ] Notion backend
  • [ ] Slack backend
  • [ ] Dropbox backend
  • [ ] User management dashboard
  • [ ] MCP server marketplace listing

Contributing

Pull requests welcome! Please read CONTRIBUTING.md first.

License

MIT License - see LICENSE file for details

Credits

Created by: Jerry Jackson (Uncle Tallest)
For: Multi-instance AI systems and neurodivergent-AI collaboration

Support

  • Issues: https://github.com/continuity-bridge/iris-mcp-server/issues
  • Documentation: https://uncletallest.productions/iris-mcp-server/docs

相关 MCP