Google Sheets API MCP Server

Google Sheets API MCP サーバー

Google Sheets API と連携するための包括的な Model Context Protocol（MCP）サーバーです。このサーバーは、スプレッドシート、シート、値、開発者メタデータを管理するためのツールとリソースを提供します。

## 機能

- スプレッドシートの作成、読み取り、更新、削除
- スプレッドシート内のシートの管理
- 値の読み取り、書き込み、追加、クリア
- 開発者メタデータの操作
- MCP リソースを通じたスプレッドシートデータへのアクセス

## 前提条件

- Node.js 16 以降
- Google Sheets API を有効にした Google Cloud Platform プロジェクト
- OAuth 2.0 認証情報（クライアント ID、クライアントシークレット、リフレッシュトークン）

## セットアップ

1. このリポジトリをクローンします
2. 依存関係をインストールします：
   ```
   npm install
   ```
3. Google API 認証情報を記載した `.env.example` をもとに `.env` ファイルを作成します：
   ```
   CLIENT_ID=your_client_id
   CLIENT_SECRET=your_client_secret
   REDIRECT_URI=your_redirect_uri
   REFRESH_TOKEN=your_refresh_token
   ```

## 使用方法

### サーバーの実行

```
npm start
```

### 開発モード

```
npm run dev
```

### MCP Inspector でのテスト

```
npm run inspect
```

## 利用可能なツール

### スプレッドシートの管理

- `createSpreadsheet`：新しいスプレッドシートを作成
- `getSpreadsheet`：スプレッドシートの詳細を取得
- `batchUpdate`：スプレッドシートに複数の更新を適用

### シートの管理

- `copySheet`：シートを別のスプレッドシートにコピー
- `addSheet`：スプレッドシートに新しいシートを追加
- `deleteSheet`：スプレッドシートからシートを削除
- `updateSheetProperties`：シートのプロパティを更新

### 値の管理

- `getValues`：範囲から値を取得
- `updateValues`：範囲内の値を更新
- `appendValues`：範囲に値を追加
- `clearValues`：範囲内の値をクリア
- `batchGetValues`：複数の範囲から値を取得
- `batchUpdateValues`：複数の範囲内の値を更新

### 開発者メタデータ

- `getDeveloperMetadata`：すべての開発者メタデータを取得
- `createDeveloperMetadata`：新しい開発者メタデータを作成
- `updateDeveloperMetadata`：既存の開発者メタデータを更新
- `deleteDeveloperMetadata`：開発者メタデータを削除

## 利用可能なリソース

- `sheets://spreadsheet/{spreadsheetId}`：スプレッドシートの詳細を取得
- `sheets://spreadsheet/{spreadsheetId}/sheet/{sheetName}`：シートの詳細を取得
- `sheets://spreadsheet/{spreadsheetId}/values/{range}`：範囲から値を取得
- `sheets://spreadsheet/{spreadsheetId}/metadata`：すべての開発者メタデータを取得

## 認証

このサーバーは、Google Sheets API の認証に OAuth 2.0 を使用します。`.env` ファイルに次の認証情報を指定する必要があります：

- `CLIENT_ID`：Google API のクライアント ID
- `CLIENT_SECRET`：Google API のクライアントシークレット
- `REDIRECT_URI`：Google API プロジェクトで設定したリダイレクト URI
- `REFRESH_TOKEN`：OAuth 2.0 フローを通じて取得したリフレッシュトークン

## ライセンス

MIT