Servidor de Google Workspace de MCP

Un servidor de Protocolo de contexto de modelo (MCP) que permite que los agentes de IA interactúen con los servicios de Google Workspace (Drive, Docs y Sheets).

🌟 Características

Google Drive: buscar archivos, crear carpetas
Google Docs: crear, leer y actualizar documentos
Hojas de cálculo de Google: crear hojas de cálculo, leer y escribir valores de celdas
Múltiples modos de transporte: stdio (predeterminado), SSE, WebSocket
Soporte de cliente compatible con MCP (Cursor, etc.)

📋 Instalación

Uso de uv (recomendado)

uvx mcp-google-suite

Usando pip

pip install mcp-google-suite

Configuración de desarrollo

# Clone and install
git clone git@github.com:adexltd/mcp-google-suite.git && cd mcp-google-suite
uv venv && source .venv/bin/activate  # or .venv\Scripts\activate on Windows
uv pip install -e .

🔧 Configuración

Configurar para clientes MCP

Agregue a la configuración de su cliente (por ejemplo, Cursor, Claude):

Usando uvx (recomendado):

{
  "mcpServers": {
    "mcp-google-suite": {
      "command": "uvx",
      "args": ["mcp-google-suite"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json",
        "GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json"
      }
    }
  }
}

Usando la instalación de pip:

{
  "mcpServers": {
    "mcp-google-suite": {
      "command": "python",
      "args": ["-m", "mcp_google_suite"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json",
        "GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json"
      }
    }
  }
}

Configuración de Google OAuth

Visita la consola de Google Cloud
Habilitar las API de Drive, Docs y Sheets
Crear credenciales OAuth 2.0
Guardar como ~/.google/oauth.keys.json
Ejecute mcp-google auth para autenticarse

Herramientas disponibles

Operaciones de conducción

drive_search_files : Buscar archivos en Google Drive
- query (cadena, obligatoria): Consulta de búsqueda
- page_size (entero, opcional): Número de resultados a devolver
drive_create_folder : Crea una nueva carpeta
- name (cadena, obligatorio): nombre de la carpeta
- parent_id (cadena, opcional): ID de la carpeta principal

Operaciones de documentos

docs_create : Crea un nuevo documento
- title (cadena, obligatorio): Título del documento
- content (cadena, opcional): contenido inicial
docs_get_content : Obtener el contenido del documento
- document_id (cadena, obligatoria): ID del documento
docs_update_content : Actualizar el contenido del documento
- document_id (cadena, obligatoria): ID del documento
- content (cadena, obligatorio): Nuevo contenido

Operaciones con hojas de cálculo

sheets_create : Crea una nueva hoja de cálculo
- title (cadena, obligatorio): título de la hoja de cálculo
- sheets (matriz, opcional): nombres de hojas
sheets_get_values : Obtener valores de celda
- spreadsheet_id (cadena, obligatoria): ID de la hoja de cálculo
- range (cadena, obligatorio): rango de notación A1
sheets_update_values : Actualizar valores de celda
- spreadsheet_id (cadena, obligatoria): ID de la hoja de cálculo
- range (cadena, obligatorio): rango de notación A1
- values (matriz, obligatorio): matriz 2D de valores

🛠️ Desarrollo

# Install dev dependencies
uv pip install -e ".[dev]"

# Setup pre-commit hooks
pre-commit install

# Run tests
pytest

# Format code
black . && ruff check --fix .

🔍 Depuración

Utilice el Inspector MCP para realizar pruebas interactivas:

# Using uvx
npx @modelcontextprotocol/inspector uvx mcp-google

# For development
cd path/to/mcp-google-suite
npx @modelcontextprotocol/inspector uv run mcp-google

📚 Recursos

🤝 Contribuyendo

Lea CONTRIBUTING.md para obtener detalles sobre nuestro código de conducta y el proceso para enviar solicitudes de extracción.

🔒 Seguridad

Consulte SECURITY.md para informar vulnerabilidades y mejores prácticas.

📄 Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.

MCP Google Workspace Server

Integrations