MCP Google Workspace 서버

AI 에이전트가 Google Workspace(Drive, Docs, Sheets) 서비스와 상호 작용할 수 있도록 하는 MCP(Model Context Protocol) 서버입니다.

🌟 특징

Google 드라이브: 파일 검색, 폴더 생성
Google 문서: 문서 만들기, 읽기, 업데이트
Google 시트: 스프레드시트 만들기, 셀 값 읽기/쓰기
다양한 전송 모드: stdio(기본값), SSE, WebSocket
MCP 호환 클라이언트 지원(커서 등)

📋 설치

uv 사용(권장)

지엑스피1

pip 사용하기

pip install mcp-google-suite

개발 설정

# Clone and install
git clone git@github.com:adexltd/mcp-google-suite.git && cd mcp-google-suite
uv venv && source .venv/bin/activate  # or .venv\Scripts\activate on Windows
uv pip install -e .

🔧 구성

MCP 클라이언트에 대한 구성

클라이언트 설정(예: 커서, 클로드)에 다음을 추가합니다.

uvx 사용(권장):

{
  "mcpServers": {
    "mcp-google-suite": {
      "command": "uvx",
      "args": ["mcp-google-suite"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json",
        "GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json"
      }
    }
  }
}

pip 설치 사용:

{
  "mcpServers": {
    "mcp-google-suite": {
      "command": "python",
      "args": ["-m", "mcp_google_suite"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json",
        "GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json"
      }
    }
  }
}

Google OAuth 설정

Google Cloud Console 방문
Drive, Docs 및 Sheets API 사용 설정
OAuth 2.0 자격 증명 만들기
~/.google/oauth.keys.json 으로 저장
mcp-google auth 실행하여 인증하세요.

사용 가능한 도구

드라이브 운영

drive_search_files : Google Drive에서 파일 검색
- query (문자열, 필수): 검색 쿼리
- page_size (정수, 선택 사항): 반환할 결과 수
drive_create_folder : 새 폴더 만들기
- name (문자열, 필수): 폴더 이름
- parent_id (문자열, 선택 사항): 상위 폴더 ID

문서 작업

docs_create : 새 문서를 만듭니다
- title (문자열, 필수): 문서 제목
- content (문자열, 선택 사항): 초기 콘텐츠
docs_get_content : 문서 내용 가져오기
- document_id (문자열, 필수): 문서 ID
docs_update_content : 문서 내용 업데이트
- document_id (문자열, 필수): 문서 ID
- content (문자열, 필수): 새 콘텐츠

시트 작업

sheets_create : 새 스프레드시트를 만듭니다
- title (문자열, 필수): 스프레드시트 제목
- sheets (배열, 선택 사항): 시트 이름
sheets_get_values : 셀 값 가져오기
- spreadsheet_id (문자열, 필수): 스프레드시트 ID
- range (문자열, 필수): A1 표기법 범위
sheets_update_values : 셀 값 업데이트
- spreadsheet_id (문자열, 필수): 스프레드시트 ID
- range (문자열, 필수): A1 표기법 범위
- values (배열, 필수): 값의 2차원 배열

🛠️ 개발

# Install dev dependencies
uv pip install -e ".[dev]"

# Setup pre-commit hooks
pre-commit install

# Run tests
pytest

# Format code
black . && ruff check --fix .

🔍 디버깅

대화형 테스트를 위해 MCP Inspector를 사용하세요.

# Using uvx
npx @modelcontextprotocol/inspector uvx mcp-google

# For development
cd path/to/mcp-google-suite
npx @modelcontextprotocol/inspector uv run mcp-google

📚 리소스

🤝 기여하기

행동 강령과 풀 리퀘스트 제출 프로세스에 대한 자세한 내용은 CONTRIBUTING.md를 읽어보세요.

🔒 보안

취약점 보고 및 모범 사례는 SECURITY.md를 참조하세요.

📄 라이센스

MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.

MCP Google Workspace Server

Integrations