Iris MCP Server
Iris MCP 서버
단일 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
Drive API가 활성화된 Google Cloud 프로젝트
OAuth 2.0 자격 증명 (클라이언트 ID 및 보안 비밀)
설정
복제 및 종속성 설치:
git clone https://github.com/continuity-bridge/iris-mcp-server.git
cd iris-mcp-server
npm install환경 구성:
cp .env.example .env
# Edit .env with your Google OAuth credentials빌드:
npm run build로컬 테스트:
npx @modelcontextprotocol/inspector node dist/index.jsHTTP 모드 설정 (브라우저 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 설정
새 프로젝트를 생성하거나 기존 프로젝트 선택
Google Drive API 활성화
OAuth 2.0 자격 증명 생성:
애플리케이션 유형: 웹 애플리케이션
승인된 리디렉션 URI:
https://iris.uncletallest.productions/oauth/callback
클라이언트 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 buildMCP 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 협업
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/continuity-bridge/iris-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server