hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Enables creation, reading, and updating of Google Docs with tools to manage document content
Provides file search capabilities and folder creation within Google Drive
Allows creation of spreadsheets and managing cell values through range-based operations

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 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Google Workspace와 원활하게 통합되어 안전한 OAuth2 인증을 통해 Google Drive, Docs 및 Sheets 작업이 가능한 모델 컨텍스트 프로토콜 서버입니다.

MCP Google Suite