Servidor MCP de hojas de cálculo

Este proyecto es un servidor de Protocolo de Contexto de Modelo (MCP) para acceder a datos en hojas de cálculo de Google. Permite que LLM utilice directamente la información de la hoja de cálculo.

función

• Adquirir información básica sobre una hoja de cálculo (como una lista de hojas)

• Obtener datos de una hoja específica y formatearla en formato Markdown

• Se integra con clientes MCP (por ejemplo, Claude para escritorio)

Related MCP server: mcp-google-sheets

instalar

# リポジトリのクローン
git clone https://github.com/your-username/spreadsheet-mcp-server.git
cd spreadsheet-mcp-server

# 依存関係のインストール
npm install

# 環境変数の設定
cp .env.example .env
# .envファイルを編集してGAS_WEB_APP_URLとGAS_API_KEYを設定

# ビルド
npm run build

Configuración de variables de entorno

Las siguientes variables de entorno se utilizan para configurar el servidor:

• GAS_WEB_APP_URL : URL de la aplicación web de Google Apps Script

• GAS_API_KEY : Clave API para acceder a la aplicación web de Google Apps Script

Puede configurar estas variables de entorno en el archivo .env :

GAS_WEB_APP_URL=https://script.google.com/macros/s/your-deployment-id/exec
GAS_API_KEY=your-api-key

Si no se configura la variable de entorno, el servidor funcionará en modo simulado y no accederá a la hoja de cálculo de Google real.

Cómo utilizar

Startup independiente

npm start

Integración con Claude para escritorio

Agregue lo siguiente a su archivo de configuración de Claude for Desktop ( claude_desktop_config.json ):

{
  "mcpServers": {
    "spreadsheet": {
      "command": "node",
      "args": ["<absolute-path-to-project>/build/index.js"]
    }
  }
}

Para establecer una variable de entorno, agregue env de la siguiente manera:

{
  "mcpServers": {
    "spreadsheet": {
      "command": "node",
      "args": ["<absolute-path-to-project>/build/index.js"],
      "env": {
        "GAS_WEB_APP_URL": "https://script.google.com/macros/s/your-deployment-id/exec",
        "GAS_API_KEY": "your-api-key"
      }
    }
  }
}

El archivo de configuración se encuentra aquí:

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

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

Prueba con MCP Inspector

npx @modelcontextprotocol/inspector node build/index.js

Herramientas proporcionadas

obtenerHoja de cálculo

Obtiene información básica sobre una hoja de cálculo y una lista de las hojas que contiene.

Parámetros de entrada :

• url : La URL de la hoja de cálculo

producción :

• Nombre de la hoja de cálculo, ID, lista de hojas (incluido el número de filas y columnas)

obtenerDatosDeHoja

Obtiene datos de una hoja específica en una hoja de cálculo.

Parámetros de entrada :

• url : La URL de la hoja de cálculo

• sheetName : El nombre de la hoja a obtener

producción :

• Datos de la hoja (formato de tabla Markdown)

desarrollo

Estructura del proyecto

src/
├── index.ts           # エントリポイント
├── server.ts          # MCPサーバー設定
├── config.ts          # 環境変数と設定管理
├── tools/             # ツール実装
│   ├── getSpreadsheet.ts
│   ├── getSheetData.ts
│   └── index.ts
├── api/               # API処理
│   ├── README.md      # API仕様
│   ├── spreadsheet.ts
│   └── types.ts
└── utils/             # ユーティリティ
    └── format.ts

prueba

# 単体テスト実行
npm test

# ウォッチモードでテスト
npm run test:watch

Integración con Google Apps Script

En el uso real, este servidor funciona junto con una aplicación web de Google Apps Script:

1. Crear una aplicación web con Google Apps Script

2. Implementar una API para acceder a la hoja de cálculo en el lado de la aplicación web (ver api/README.md )

3. Establezca la clave API y vincúlela con las variables de entorno GAS_WEB_APP_URL y GAS_API_KEY

Este enfoque le permite evitar el flujo de autenticación de Google y mantener la seguridad de su hoja de cálculo.

Si no se configura la variable de entorno, el script funcionará en modo simulado y devolverá datos de prueba.

licencia

Instituto Tecnológico de Massachusetts (MIT)