MCP Google Workspace Server

MCP Google Workspace Server

Um servidor Model Context Protocol (MCP) que permite que agentes de IA interajam com os serviços do Google Workspace (Drive, Docs e Sheets).

🌟 Recursos

• Google Drive: Pesquisar arquivos, criar pastas
• Google Docs: Criar, ler e atualizar documentos
• Google Sheets: Criar planilhas, ler/gravar valores de células
• Múltiplos modos de transporte: stdio (padrão), SSE, WebSocket
• Suporte a clientes compatíveis com MCP (Cursor, etc.)

📋 Instalação

Usando uv (recomendado)

uvx mcp-google-suite

Usando pip

pip install mcp-google-suite

Configuração de desenvolvimento

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

🔧 Configuração

Configurar para clientes MCP

Adicione às configurações do seu cliente (ex.: 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 instalação via 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"
      }
    }
  }
}

Configuração do Google OAuth

1. Visite o Google Cloud Console
2. Ative as APIs do Drive, Docs e Sheets
3. Crie credenciais OAuth 2.0
4. Salve como ~/.google/oauth.keys.json
5. Execute mcp-google auth para autenticar

Ferramentas disponíveis

Operações do Drive

• drive_search_files: Pesquisar arquivos no Google Drive
  • query (string, obrigatório): Consulta de pesquisa
  • page_size (inteiro, opcional): Número de resultados a retornar
• drive_create_folder: Criar uma nova pasta
  • name (string, obrigatório): Nome da pasta
  • parent_id (string, opcional): ID da pasta pai

Operações do Docs

• docs_create: Criar um novo documento
  • title (string, obrigatório): Título do documento
  • content (string, opcional): Conteúdo inicial
• docs_get_content: Obter conteúdo do documento
  • document_id (string, obrigatório): ID do documento
• docs_update_content: Atualizar conteúdo do documento
  • document_id (string, obrigatório): ID do documento
  • content (string, obrigatório): Novo conteúdo

Operações do Sheets

• sheets_create: Criar uma nova planilha
  • title (string, obrigatório): Título da planilha
  • sheets (array, opcional): Nomes das planilhas
• sheets_get_values: Obter valores de células
  • spreadsheet_id (string, obrigatório): ID da planilha
  • range (string, obrigatório): Intervalo em notação A1
• sheets_update_values: Atualizar valores de células
  • spreadsheet_id (string, obrigatório): ID da planilha
  • range (string, obrigatório): Intervalo em notação A1
  • values (array, obrigatório): Matriz 2D de valores

🛠️ Desenvolvimento

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

# Setup pre-commit hooks
pre-commit install

# Run tests
pytest

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

🔍 Depuração

Use o MCP Inspector para testes interativos:

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

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

📚 Recursos

• Documentação
• MCP Inspector
• Pre-commit Hooks
• Google Cloud Console

🤝 Contribuição

Leia CONTRIBUTING.md para obter detalhes sobre nosso código de conduta e o processo para envio de pull requests.

🔒 Segurança

Consulte SECURITY.md para relatar vulnerabilidades e conhecer as melhores práticas.

📄 Licença

Licença MIT - Consulte o arquivo LICENSE para obter detalhes.