systemprompt-mcp-google
Sitio web | Documentación | Blog
Un servidor especializado de Protocolo de Contexto de Modelo (MCP) que integra los servicios de Google (Gmail, Calendario, etc.) en tus flujos de trabajo de IA. Este servidor permite un acceso fluido a los servicios de Google a través de MCP, lo que permite a los agentes de IA interactuar con Gmail, Calendario de Google y otros servicios de Google.
Manifestación
Demostración de YouTube
Prerrequisitos
Antes de utilizar este servidor, necesitarás:
- Una clave API de Systemprompt (gratuita):
- Un cliente compatible con MCP como:
- Configuración del proyecto de Google Cloud:
- Una cuenta de Google Cloud
- Acceso API habilitado para los servicios deseados (Gmail, Calendario, etc.)
- Credenciales OAuth2 configuradas
Configuración
1. Configuración de Google Cloud
- Crear un proyecto en Google Cloud Console
- Habilite las API que necesita:
- API de Gmail (leer, enviar, redactar, modificar, etiquetas)
- API de Google Calendar (leer eventos)
- API de Google Drive (solo lectura)
- Crear credenciales OAuth2:
- Vaya a "API y servicios" > "Credenciales".
- Crear un ID de cliente OAuth 2.0
- Establecer URI de redireccionamiento autorizados (incluir
http://localhost:3333/oauth2callback ) - Descargue el archivo JSON de credenciales y guárdelo como
credentials/google-credentials.json
2. Configuración del servidor
- Instalar el paquete:
npm install systemprompt-mcp-google
- Cree el directorio de credenciales:
- Ejecute el script de autenticación:
Esto hará lo siguiente:
- Abra su navegador predeterminado para la autenticación de Google OAuth
- Inicie un servidor local en el puerto 3333 para manejar la devolución de llamada OAuth
- Generar y guardar tokens en
credentials/google-token.json - Cerrar automáticamente una vez completada la autenticación
El script solicitará los siguientes permisos:
- Gmail: leer, enviar, redactar, modificar y administrar etiquetas
- Calendario: leer eventos y calendarios
- Unidad: acceso de solo lectura
3. Configuración del cliente MCP
Elige tu cliente MCP preferido:
Uso del cliente MCP Systemprompt
- Instalar y configurar el cliente siguiendo sus instrucciones de configuración
- En la configuración MCP del cliente, agregue este servidor:
{
"servers": {
"google": {
"type": "stdio",
"command": "SYSTEMPROMPT_API_KEY=your_api_key npx systemprompt-mcp-google"
}
}
}
Nota: Reemplace your_api_key con su clave API de Systemprompt real desde systemprompt.io/console .
Uso de Claude Desktop
- Instalar Claude Desktop
- Agregue este servidor en la sección de configuración de MCP de Claude con la clave API:
{
"command": "SYSTEMPROMPT_API_KEY=your_api_key npx systemprompt-mcp-google"
}
- Configurar la conexión para utilizar el modo stdio
Características
Integración de servicios de Google
- Integración con Gmail
- Leer y enviar correos electrónicos mediante comandos MCP
- Administrar borradores y archivos adjuntos
- Buscar y filtrar correos electrónicos
- Gestionar hilos de correo electrónico
- Integración de calendario
- Crear y gestionar eventos mediante comandos MCP
- Gestionar invitaciones a eventos
- Buscar y filtrar eventos del calendario
- Administrar múltiples calendarios
Integración MCP
- Interfaz MCP estándar
- Compatible con cualquier cliente compatible con MCP
- Respuestas de comando estructuradas
- Manejo de errores e informes de estado
- Gestión de sesiones
Seguridad y autenticación
- Flujo de autenticación segura de OAuth2
- Actualización automática del token
- Acceso limitado para diferentes servicios
- Configuración basada en el entorno
Características de desarrollo
- Compatibilidad total con TypeScript
- Manejo integral de errores
- Amplia cobertura de pruebas
- Interfaz compatible con MCP
Configuración
- Configurar el proyecto Google Cloud y las credenciales de OAuth2:
- Crear un proyecto en Google Cloud Console
- Habilitar las API de Gmail y Calendario
- Crear credenciales OAuth2
- Descargar archivo de credenciales
- Configurar variables de entorno:
GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret
GOOGLE_REDIRECT_URI=your_redirect_uri
- Ejecute el script de autenticación:
Uso
A través del cliente MCP
Una vez configurado, puede usar cualquier cliente MCP para enviar comandos a este servidor. Ejemplos de interacciones:
Operaciones de Gmail
// Example MCP command structure for sending an email
{
"command": "gmail.sendEmail",
"parameters": {
"to": "recipient@example.com",
"subject": "Hello from MCP",
"body": "This email was sent via MCP!"
}
}
// Example MCP command for listing messages
{
"command": "gmail.listMessages",
"parameters": {
"maxResults": 10
}
}
Operaciones del calendario
// Example MCP command for creating an event
{
"command": "calendar.createEvent",
"parameters": {
"summary": "Team Meeting",
"start": "2024-03-01T10:00:00",
"end": "2024-03-01T11:00:00",
"attendees": ["team@company.com"]
}
}
// Example MCP command for listing events
{
"command": "calendar.listEvents",
"parameters": {
"timeMin": "2024-03-01T00:00:00Z",
"maxResults": 10
}
}
Pruebas
El proyecto incluye pruebas integrales tanto para el manejo del protocolo MCP como para la integración del servicio de Google:
# Run all tests
npm test
# Watch mode for development
npm run test:watch
# Generate coverage report
npm run test:coverage
Depuración de la comunicación MCP
Dado que los servidores MCP se comunican a través de stdio, la depuración requiere una consideración especial:
- Utilice el inspector MCP:
- Habilitar el registro de depuración:
# Set environment variable
DEBUG=mcp:* npm run dev
- Utilice el cliente de prueba proporcionado:
Licencia
Instituto Tecnológico de Massachusetts (MIT)
Proyectos relacionados
Desarrollo
Configuración de desarrollo local
- Clonar el repositorio:
git clone https://github.com/yourusername/systemprompt-mcp-google.git
cd systemprompt-mcp-google
- Instalar dependencias:
- Configurar variables de entorno:
# Copy example environment file
cp .env.example .env
# Edit .env and add:
SYSTEMPROMPT_API_KEY=your_api_key # Required - get from systemprompt.io/console
- Configurar las credenciales de Google:
- Guarde sus credenciales de Google OAuth como
credentials/google-credentials.json - Ejecute
npm run auth-google para autenticarse con Google
- Iniciar servidor de desarrollo: