Servidor de Google Workspace de MCP

👁 CI
👁 código decodificador
👁 Versión de PyPI
👁 Licencia: MIT
👁 Estilo de código: negro

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 Suite

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

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• docs_createC
• docs_get_contentC
• docs_update_contentC
• drive_create_folderC
• drive_search_filesC
• sheets_createC
• sheets_get_valuesC
• sheets_update_valuesC