Spreadsheet MCP Server

이 프로젝트는 Google Spreadsheet 데이터에 액세스하기 위한 MCP(Model Context Protocol) 서버입니다. LLM이 스프레드시트 정보를 직접 사용할 수 있도록 합니다.

기능

• 스프레드시트의 기본 정보(시트 목록 등) 획득

• 특정 시트의 데이터 검색 및 마크다운 형식으로 성형

• MCP 클라이언트(예: Claude for Desktop)와 통합

Related MCP server: mcp-google-sheets

설치

환경 변수 설정

서버 설정에는 다음 환경 변수가 사용됩니다.

• GAS_WEB_APP_URL : Google Apps Script Web App URL

• GAS_API_KEY : Google Apps Script Web App 액세스용 API 키

이러한 환경 변수는 .env 파일에 설정할 수 있습니다.

환경 변수가 설정되어 있지 않으면 서버가 모의 모드로 작동하고 실제 Google 스프레드시트에 액세스하지 않습니다.

사용방법

독립형으로 시작

Claude for Desktop과의 통합

Claude for Desktop 구성 파일( claude_desktop_config.json )에 다음을 추가합니다.

환경 변수를 설정하려면 다음과 같이 env 필드를 추가합니다.

구성 파일은 다음 위치에 있습니다.

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

• Windows: %AppData%\\Claude\\claude_desktop_config.json

MCP Inspector로 테스트

제공하는 도구

getSpreadsheet

스프레드시트의 기본 정보와 포함된 시트 목록을 가져옵니다.

입력 파라미터 :

• url : 스프레드 시트 URL

산출 :

• 스프레드시트 이름, ID, 시트 목록(행 및 열 수 포함)

getSheetData

스프레드시트의 특정 시트에 대한 데이터를 가져옵니다.

입력 파라미터 :

• url : 스프레드 시트 URL

• sheetName : 검색할 시트 이름

산출 :

• 시트 데이터(마크다운 테이블 형식)

개발

프로젝트 구조

테스트

Google Apps Script와의 연동 정보

이 서버는 실제 사용 시 Google Apps Script 웹 애플리케이션과 함께 작동합니다.

1. Google Apps Script로 웹 앱 만들기

2. 웹 앱에서 스프레드시트에 액세스하는 API 구현( api/README.md 참조)

3. API 키를 설정하고 환경 변수 GAS_WEB_APP_URL 과 GAS_API_KEY 로 연동

이 방법을 사용하면 Google 인증 흐름을 피하고 스프레드시트의 보안을 유지할 수 있습니다.

환경 변수가 설정되어 있지 않으면 모의 모드로 작동하고 테스트 데이터를 반환합니다.

라이센스

MIT