Skip to main content
Glama
deenesjakoruzh
reclamation-bridge

Iris MCP Server

by reclamation-bridge
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Iris MCP 服务器

多后端 MCP 网关，通过单个 MCP 连接器提供 Google Drive 写入权限、Notion 等功能。

概述

Iris 通过充当网关解决了免费版 MCP 连接器的限制：用户只需连接一个自定义连接器（Iris），即可获得对多个后端服务的完全读写能力。

两种模式：

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 后端（读 + 写）

Related MCP server: google-workspace-mcp-server

安装

先决条件

  • Node.js 18+ 和 npm

  • 已启用 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

  1. 配置环境：

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

  1. 构建：

npm run build

  1. 本地测试：

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 凭据：

    • 应用程序类型：Web 应用程序

    • 已获授权的重定向 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 服务器市场列表

贡献

欢迎提交 Pull Request！请先阅读 CONTRIBUTING.md。

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件

致谢

创建者： Jerry Jackson (Uncle Tallest) 用途： 多实例 AI 系统和神经多样性 AI 协作

支持

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers