Google MCP ChatGPT Self-host

일반 ChatGPT 대화에서 개인 MCP 연결을 통해 폭이 제한된 Google MCP 데이터를 읽기 위한 비공식 단일 사용자 참조 구현입니다.

이 저장소는 소스 코드 및 배포 가이드입니다. 기존 MCP 서비스, ChatGPT 앱, 터널, Google Cloud 프로젝트, 자격 증명 또는 건강 데이터를 게시하거나 노출하지 않습니다. 각 배포자는 독립된 Google Cloud 프로젝트, OAuth 권한 부여, ChatGPT 터널, 호스트, ChatGPT Developer Mode 앱을 직접 생성하고 소유합니다.

제공 기능

• 정확히 4개의 읽기 전용 도구를 갖춘 Node.js stdio MCP 서버.

• 고정된 Google Health 읽기 전용 OAuth 범위 4개.

• 고정된 데이터 유형 허용 목록: reconcile 유형 32개, rollup 유형 18개, IRN 기록.

• 서버에서 생성되는 Google 필터, 닫힘-열림 범위 검증, 페이지 크기 제한, 개인정보 보호 필드 마스크.

• 전체 본문이 버퍼링되기 전에 스트리밍 중에 적용되는 90,000바이트 업스트림 응답 제한.

• 웹 ChatGPT가 별도의 개인 기준선 없이 올바른 작업을 선택할 수 있도록 MCP 지침, 도구 설명 및 스키마에 포함된 쿼리 라우팅 메타데이터.

• 개발, 검토, 평가를 위한 로컬 Skill 및 쿼리 카탈로그. Developer Mode는 이 Skill을 웹 ChatGPT에 자동으로 가져오지 않습니다.

• Google Cloud OAuth, Linux/systemd, OpenAI Secure MCP Tunnel, ChatGPT, Scheduled task, 개인정보 보호 및 문제 해결 가이드.

Related MCP server: Fitbit Air Daily Planner MCP Server

의도된 경계

이 프로젝트는 개인 단일 사용자 배포를 위한 것입니다. 쓰기 작업, 공개 MCP 엔드포인트, 데이터베이스, 응답 캐시, 분석 파이프라인, 다중 사용자 인증, 공개 Plugin Directory 등록, 의료 진단 기능이 없습니다. 의료 기기가 아닙니다.

도구가 실행되면 요청된 건강 정보 응답은 Google Health에서 자체 호스팅 프로세스와 OpenAI 터널을 거쳐 ChatGPT 대화로 전달됩니다. 애플리케이션 코드는 해당 응답을 저장하지 않지만, 배포자는 Google, OpenAI, 호스팅 플랫폼 및 모든 인프라 로그의 정책과 데이터 보존 관행을 별도로 이해하고 공개해야 합니다.

Architecture

ChatGPT conversation or Scheduled task
                |
      private Developer Mode app
                |
       OpenAI Secure MCP Tunnel
        outbound HTTPS only
                |
          tunnel-client host
                |
         stdio Node.js MCP
                |
     Google OAuth refresh on demand
                |
       health.googleapis.com

Secure MCP Tunnel은 MCP 서버를 공개 인터넷에 노출하지 않는 개발 전용 연결입니다. 공개 플러그인 제출 경로는 아닙니다.

읽기 전용 계약

OAuth 권한은 다음 범위로 고정됩니다:

https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly
https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly
https://www.googleapis.com/auth/googlehealth.irn.readonly
https://www.googleapis.com/auth/googlehealth.sleep.readonly

MCP 서버는 다음 도구를 제공합니다:

전체 유형-방법 매트릭스는 skills/Google-health-query/query-catalog.md에서 확인할 수 있습니다.

배포 경로

1. docs/architecture-and-scope.md 및 docs/privacy-and-security.md를 읽습니다.

2. docs/google-cloud-oauth.md로 독립된 Google Cloud 프로젝트와 OAuth 클라이언트를 구성합니다.

3. docs/local-offline-grant.md로 단일 사용자 오프라인 권한을 획득합니다.

4. docs/deploy-linux-systemd.md로 MCP 서버를 빌드하고 설치합니다.

5. docs/openai-secure-mcp-tunnel.md로 개인 터널을 생성하고 실행합니다.

6. docs/chatgpt-developer-mode.md로 Developer Mode 앱을 추가하고 검증합니다.

7. 대화형 수용(interactive acceptance)이 끝난 후에만 docs/scheduled-task.md로 예약 작업을 구성합니다.

이 저장소, 채팅 메시지, 이슈 보고서, 명령줄 인수, 스크린샷 또는 CI 변수에 자격 증명을 넣지 마십시오. 설치는 환경 변수의 파일 경로를 사용합니다. 파일 자체는 소유자만 읽을 수 있어야 합니다.

개발

요구 사항: Node.js 22 이상, npm, 그리고 선택적인 Codex Skill 검증기를 실행하려는 경우에만 Python 3.

npm ci
npm run check
npm run audit:discovery
npm audit

발견 감사는 Google의 공개 API 발견 문서만 확인하며, 인증하거나 건강 데이터를 조회하지 않습니다. 테스트 스위트는 합성 픽스처(synthetic fixtures)를 사용합니다.

Codex Skill 검증기가 로컬에 설치되어 있는 경우:

python3 /path/to/skill-creator/scripts/quick_validate.py skills/google-health-readonly

변경 사항을 제출하기 전에 CONTRIBUTING.md를 참조하세요. 이슈 또는 풀 리퀘스트에 실제 건강 데이터, 조회 결과, 계정 식별자, OAuth 값, 터널 ID, 개인 운영 콘솔의 스크린샷을 포함하지 마십시오.

License

Apache License 2.0. LICENSE 및 NOTICE를 참조하세요.