MCP Google Workspace 서버

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

🌟 특징

• Google 드라이브: 파일 검색, 폴더 생성

• Google 문서: 문서 만들기, 읽기, 업데이트

• Google 시트: 스프레드시트 만들기, 셀 값 읽기/쓰기

• 다양한 전송 모드: stdio(기본값), SSE, WebSocket

• MCP 호환 클라이언트 지원(커서 등)

Related MCP server: MCP Google Suite

📋 설치

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 설정

1. Google Cloud Console 방문

2. Drive, Docs 및 Sheets API 사용 설정

3. OAuth 2.0 자격 증명 만들기

4. ~/.google/oauth.keys.json 으로 저장

5. 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

📚 리소스

• 선적 서류 비치

• MCP 검사관

• 사전 커밋 후크

• 구글 클라우드 콘솔

🤝 기여하기

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

🔒 보안

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

📄 라이센스

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