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.)

Related MCP server: mcp-google-sheets

📋 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

1. Visita la consola de Google Cloud

2. Habilitar las API de Drive, Docs y Sheets

3. Crear credenciales OAuth 2.0

4. Guardar como ~/.google/oauth.keys.json

5. 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

• Documentación

• Inspector de MCP

• Ganchos de pre-confirmación

• Consola de Google Cloud

🤝 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.