local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables AI agents to read, send, manage drafts and attachments, search and filter emails, and handle email threads through MCP commands
Allows AI agents to create and manage events, handle event invitations, search and filter calendar events, and manage multiple calendars through MCP commands
Provides read-only access to Google Drive content through MCP, allowing AI agents to interact with files and documents

시스템 프롬프트-mcp-google

Google 서비스(Gmail, 캘린더 등)를 AI 워크플로에 통합하는 특수 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 MCP를 통해 Google 서비스에 원활하게 액세스할 수 있도록 하여 AI 에이전트가 Gmail, Google 캘린더 및 기타 Google 서비스와 상호 작용할 수 있도록 지원합니다.

데모

유튜브 데모

필수 조건

이 서버를 사용하려면 다음이 필요합니다.

Systemprompt API 키(무료):
- systemprompt.io/console 에 가입하세요
- 새로운 API 키 생성
- 서버를 실행하려면 필요합니다
다음과 같은 MCP 호환 클라이언트:
- Systemprompt MCP 클라이언트
- 클로드 데스크탑
- 또는 다른 MCP 호환 클라이언트
Google Cloud 프로젝트 설정:
- Google Cloud 계정
- 원하는 서비스(Gmail, 캘린더 등)에 대한 API 접근이 활성화되었습니다.
- OAuth2 자격 증명이 구성됨

설정

1. Google Cloud 설정

Google Cloud Console 에서 프로젝트 만들기
필요한 API를 활성화하세요.
- Gmail API(읽기, 보내기, 작성, 수정, 라벨)
- Google 캘린더 API(이벤트 읽기)
- Google 드라이브 API(읽기 전용)
OAuth2 자격 증명을 만듭니다.
- "API 및 서비스" > "자격 증명"으로 이동하세요.
- OAuth 2.0 클라이언트 ID 만들기
- 승인된 리디렉션 URI 설정( http://localhost:3333/oauth2callback 포함)
- 자격 증명 JSON 파일을 다운로드하여 credentials/google-credentials.json 으로 저장합니다.

2. 서버 구성

패키지를 설치하세요:

지엑스피1

자격 증명 디렉터리를 만듭니다.

mkdir -p credentials

인증 스크립트를 실행합니다.

npm run auth-google

이렇게 하면:

Google OAuth 인증을 위해 기본 브라우저를 엽니다.
OAuth 콜백을 처리하기 위해 포트 3333에서 로컬 서버를 시작합니다.
토큰을 생성하여 credentials/google-token.json 에 저장합니다.
인증이 완료되면 자동으로 닫힙니다.

스크립트는 다음과 같은 권한을 요청합니다.

Gmail: 라벨 읽기, 보내기, 작성, 수정 및 관리
캘린더: 이벤트 및 캘린더 읽기
드라이브: 읽기 전용 액세스

3. MCP 클라이언트 설정

원하는 MCP 클라이언트를 선택하세요:

Systemprompt MCP 클라이언트 사용

설정 지침 에 따라 클라이언트를 설치하고 구성합니다.
클라이언트의 MCP 구성에서 이 서버를 추가합니다.

{
  "servers": {
    "google": {
      "type": "stdio",
      "command": "SYSTEMPROMPT_API_KEY=your_api_key npx systemprompt-mcp-google"
    }
  }
}

참고: your_api_key systemprompt.io/console 의 실제 Systemprompt API 키로 바꾸세요.

Claude Desktop 사용

Claude Desktop 설치
API 키와 함께 Claude의 MCP 구성 섹션에 이 서버를 추가합니다.
{ "command": "SYSTEMPROMPT_API_KEY=your_api_key npx systemprompt-mcp-google" }
stdio 모드를 사용하도록 연결을 구성합니다.

특징

Google 서비스 통합

Gmail 통합
- MCP 명령을 통해 이메일 읽기 및 보내기
- 초안 및 첨부 파일 관리
- 이메일 검색 및 필터링
- 이메일 스레드 처리
캘린더 통합
- MCP 명령을 통해 이벤트를 생성하고 관리합니다.
- 이벤트 초대장 처리
- 캘린더 이벤트 검색 및 필터링
- 여러 캘린더 관리

MCP 통합

표준 MCP 인터페이스
- 모든 MCP 호환 클라이언트와 호환 가능
- 구조화된 명령 응답
- 오류 처리 및 상태 보고
- 세션 관리

보안 및 인증

보안 OAuth2 인증 흐름
자동 토큰 새로 고침
다양한 서비스에 대한 범위가 지정된 액세스
환경 기반 구성

개발 특징

전체 TypeScript 지원
포괄적인 오류 처리
광범위한 테스트 범위
MCP 호환 인터페이스

구성

Google Cloud Project 및 OAuth2 자격 증명을 설정합니다.
- Google Cloud Console 에서 프로젝트 만들기
- Gmail 및 캘린더 API 활성화
- OAuth2 자격 증명 만들기
- 자격 증명 파일 다운로드
환경 변수 구성:

GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret
GOOGLE_REDIRECT_URI=your_redirect_uri

인증 스크립트를 실행합니다.

npm run auth-google

용법

MCP 클라이언트를 통해

구성이 완료되면 모든 MCP 클라이언트를 사용하여 이 서버로 명령을 전송할 수 있습니다. 상호작용 예시:

Gmail 운영

// Example MCP command structure for sending an email
{
  "command": "gmail.sendEmail",
  "parameters": {
    "to": "recipient@example.com",
    "subject": "Hello from MCP",
    "body": "This email was sent via MCP!"
  }
}

// Example MCP command for listing messages
{
  "command": "gmail.listMessages",
  "parameters": {
    "maxResults": 10
  }
}

캘린더 작업

// Example MCP command for creating an event
{
  "command": "calendar.createEvent",
  "parameters": {
    "summary": "Team Meeting",
    "start": "2024-03-01T10:00:00",
    "end": "2024-03-01T11:00:00",
    "attendees": ["team@company.com"]
  }
}

// Example MCP command for listing events
{
  "command": "calendar.listEvents",
  "parameters": {
    "timeMin": "2024-03-01T00:00:00Z",
    "maxResults": 10
  }
}

테스트

이 프로젝트에는 MCP 프로토콜 처리와 Google 서비스 통합을 위한 포괄적인 테스트가 포함됩니다.

# Run all tests
npm test

# Watch mode for development
npm run test:watch

# Generate coverage report
npm run test:coverage

MCP 통신 디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅에는 특별한 고려 사항이 필요합니다.

MCP 검사기를 사용하세요:

npm run inspector

디버그 로깅 활성화:

# Set environment variable
DEBUG=mcp:* npm run dev

제공된 테스트 클라이언트를 사용하세요.

npm run test:client

특허

MIT

개발

지역 개발 설정

저장소를 복제합니다.

git clone https://github.com/yourusername/systemprompt-mcp-google.git
cd systemprompt-mcp-google

종속성 설치:

npm install

환경 변수 설정:

# Copy example environment file
cp .env.example .env

# Edit .env and add:
SYSTEMPROMPT_API_KEY=your_api_key  # Required - get from systemprompt.io/console

Google 사용자 인증 정보를 설정하세요.

Google OAuth 자격 증명을 credentials/google-credentials.json 으로 저장합니다.
npm run auth-google 실행하여 Google로 인증하세요.

개발 서버 시작:

npm run dev

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested