Google Sheets API MCP Server

Google Sheets API MCP 服务

一个功能全面的 Model Context Protocol（MCP）服务，用于与 Google Sheets API 交互。此服务提供用于管理电子表格、工作表、值和开发者元数据的工具与资源。

## 功能

- 创建、读取、更新和删除电子表格
- 管理电子表格中的工作表
- 读取、写入、追加和清除值
- 使用开发者元数据
- 通过 MCP 资源访问电子表格数据

## 前提条件

- Node.js 16 或更高版本
- 已启用 Google Sheets API 的 Google Cloud Platform 项目
- OAuth 2.0 凭据（客户端 ID、客户端密钥、刷新令牌）

## 设置

1. 克隆此仓库
2. 安装依赖：
   ```
   npm install
   ```
3. 根据 `.env.example` 创建 `.env` 文件，并填入你的 Google API 凭据：
   ```
   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`：获取所有开发者元数据

## 身份验证

此服务使用 OAuth 2.0 对 Google Sheets API 进行身份验证。你需要在 `.env` 文件中提供以下凭据：

- `CLIENT_ID`：你的 Google API 客户端 ID
- `CLIENT_SECRET`：你的 Google API 客户端密钥
- `REDIRECT_URI`：在 Google API 项目中配置的重定向 URI
- `REFRESH_TOKEN`：通过 OAuth 2.0 流程获取的刷新令牌

## 许可证

MIT