Google 문서 MCP 서버

이는 Claude를 통해 Google Docs에 연결할 수 있는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 사용하면 다음과 같은 작업을 수행할 수 있습니다.

• 드라이브에 있는 모든 Google 문서 나열

• 특정 문서의 내용을 읽어보세요

• 새 문서 만들기

• 기존 문서 업데이트

• 문서 검색

• 문서 삭제

필수 조건

• Node.js v16.0.0 이상

• Google Docs API 및 Google Drive API가 활성화된 Google Cloud 프로젝트

• Google Cloud 프로젝트에 대한 OAuth 2.0 자격 증명

Related MCP server: Google Search Console MCP

설정

1. 이 저장소를 복제하고 프로젝트 디렉토리로 이동합니다.

지엑스피1

2. 종속성 설치:

3. Google Cloud Console에서 OAuth 2.0 클라이언트 ID를 만듭니다.

   • Google Cloud Console 로 이동

   • 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요

   • Google Docs API 및 Google Drive API 활성화

   • "API 및 서비스" > "자격 증명"으로 이동하세요.

   • "자격 증명 만들기" > "OAuth 클라이언트 ID"를 클릭하세요.

   • 애플리케이션 유형으로 "데스크톱 앱"을 선택하세요

   • JSON 파일을 다운로드하여 프로젝트 디렉토리에 credentials.json 으로 저장합니다.

   중요 : credentials.json 및 token.json 파일에는 민감한 정보가 포함되어 있으며 .gitignore 통한 버전 관리에서 제외됩니다. 이 파일들을 저장소에 커밋하지 마세요.

4. 프로젝트를 빌드하세요:

5. 서버를 실행합니다:

서버를 처음 실행하면 Google 인증을 하라는 메시지가 표시됩니다. 화면의 안내에 따라 애플리케이션을 승인하세요. 그러면 액세스 토큰을 저장하는 token.json 파일이 생성됩니다.

보안 고려 사항

• 자격 증명 보안 : credentials.json 과 token.json 모두 민감한 정보를 포함하고 있으므로 공유하거나 버전 관리 시스템에 커밋해서는 안 됩니다. 이 두 파일은 이미 .gitignore 파일에 추가되어 있습니다.

• 토큰 새로 고침 : 애플리케이션은 액세스 토큰이 만료되면 자동으로 새로 고침합니다.

• 액세스 취소 : 액세스를 취소해야 하는 경우 token.json 파일을 삭제하고 Google 계정 보안 설정 으로 이동하여 권한이 부여된 애플리케이션에서 앱을 제거하세요.

데스크톱용 Claude에 연결

Claude for Desktop과 함께 이 서버를 사용하려면:

1. Claude Desktop 구성 파일을 편집하세요.

   • macOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows의 경우: %APPDATA%\Claude\claude_desktop_config.json

2. 구성에 다음을 추가하세요.

/absolute/path/to/build/server.js 빌드한 server.js 파일의 실제 경로로 바꾸세요.

3. 데스크톱에서 Claude를 다시 시작합니다.

사용자 인터페이스

Google Docs MCP 서버는 다음과 같은 사용자 친화적인 대화형 인터페이스를 제공합니다.

• 문서 정보를 깔끔하고 읽기 쉬운 형식으로 표시합니다.

• 원시 API 데이터 대신 자연어 응답을 사용합니다.

• 사람이 읽을 수 있는 방식으로 날짜를 형식화합니다.

• 작업 후 유용한 후속 질문을 제공합니다.

• OAuth 토큰과 같은 민감한 데이터를 노출하지 않습니다.

이 인터페이스 스타일은 Notion 등 다른 Claude MCP 통합과 일치하도록 디자인되어 일관되고 즐거운 사용자 경험을 제공합니다.

개발

프로젝트 구조

새로운 기능 추가

MCP 서버에 새로운 기능을 추가하려면:

1. 새로운 기능을 구현하려면 src/server.ts 파일을 수정하세요.

2. npm run build 로 프로젝트를 빌드하세요.

3. npm start 실행하여 변경 사항을 테스트하세요.

사용 가능한 리소스

• googledocs://list - 드라이브에 있는 모든 Google 문서를 나열합니다.

• googledocs://{docId} - ID로 특정 문서의 내용을 가져옵니다.

사용 가능한 도구

• create-doc - 지정된 제목과 선택적 콘텐츠로 새 Google 문서를 만듭니다.

• update-doc - 기존 Google 문서를 새 콘텐츠로 업데이트합니다(추가 또는 교체).

• insert-text - Notion이나 다른 통합 없이 문서에 텍스트를 직접 삽입합니다.

• search-docs - 특정 텍스트가 포함된 Google Docs 검색

• delete-doc - ID로 Google 문서를 삭제합니다.

사용 가능한 프롬프트

• create-doc-template - 지정된 주제와 글쓰기 스타일을 기반으로 새 문서를 만드는 데 도움이 됩니다.

• analyze-doc - 문서의 내용을 분석하고 요약을 제공합니다.

사용 예

서버가 연결되면 Claude와 함께 사용할 수 있는 몇 가지 프롬프트 예는 다음과 같습니다.

• "내 모든 Google 문서 목록을 보여주세요"

• "'회의 메모'라는 제목으로 '토론 주제: ...'라는 내용의 새 Google 문서를 만듭니다."

• "ID가 '1abc123def456'인 문서를 업데이트하여 마지막에 이 섹션을 추가하세요: ..."

• "Google 문서에서 '프로젝트 제안서'가 포함된 문서를 검색하세요."

• "ID가 '1abc123def456'인 Google 문서를 삭제하세요."

• "기후 변화에 대한 공식 문서를 작성하세요"

• "ID '1abc123def456'을 가진 문서의 내용을 분석합니다."

문제 해결

인증 문제가 발생하는 경우:

1. 프로젝트 디렉토리에서 token.json 파일을 삭제하세요.

2. 새로운 인증 흐름을 트리거하려면 서버를 다시 실행하세요.

Google Docs API에 문제가 있는 경우:

1. Google Cloud Console에서 API가 활성화되어 있는지 확인하세요.

2. OAuth 자격 증명의 범위가 올바른지 확인하세요.

기여하다

1. 저장소를 포크하세요

2. 기능 브랜치를 만듭니다: git checkout -b feature/your-feature-name

3. 변경 사항을 커밋하세요: git commit -am 'Add some feature'

4. 브랜치에 푸시: git push origin feature/your-feature-name

5. 풀 리퀘스트 제출

특허

MIT

환경 변수

다음 키를 사용하여 프로젝트 루트에 .env 파일을 만듭니다(또는 셸에서 변수를 내보냅니다).

이러한 변수가 설정되면 서버는 디스크에서 credentials.json 이나 token.json 읽으려고 시도 하지 않습니다 .