Math MCP Server for MacOS

Introducción a MCP: Dibujar y añadir texto a Keynote en macOS

Este proyecto implementa un agente matemático que utiliza el Protocolo de Control de Modelos (MCP) para realizar cálculos matemáticos y presentar resultados visualmente en Keynote para macOS. El agente puede dibujar formas y añadir texto a las diapositivas de Keynote, lo que resulta útil para crear presentaciones matemáticas.

Características

• Operaciones matemáticas (suma, resta, multiplicación, división, etc.)
• Funciones matemáticas avanzadas (factorial, logaritmos, funciones trigonométricas)
• Cálculos de valores ASCII y operaciones de suma exponencial
• Presentación visual en Keynote:
  • Dibujar rectángulos
  • Agregar texto a las diapositivas
  • Gestión automática de diapositivas

Prerrequisitos

• Python 3.x
• macOS (para la integración de Keynote)
• Keynote instalado en su sistema
• Clave API de Google Gemini

Instalación

1. Clonar el repositorio:

2. Instalar las dependencias necesarias:

3. Cree un archivo .env en la raíz del proyecto y agregue su clave API de Gemini:

Estructura del proyecto

• mcp-server.py : Contiene la implementación del servidor con herramientas matemáticas e integración con Keynote
• mcp-client.py : Implementa el cliente que se comunica con el LLM y administra el flujo de trabajo
• requirements.txt : enumera todas las dependencias de Python

Uso

El script del cliente ( mcp-client.py ) gestiona automáticamente el inicio y la comunicación con el servidor MCP. Solo necesita ejecutar el cliente con su consulta:

Por ejemplo:

Si no se proporciona ninguna consulta, el script utilizará una consulta predeterminada mencionada en el ejemplo anterior.

El cliente:

1. Iniciar automáticamente el servidor MCP en segundo plano
2. Abra Keynote y cree un nuevo documento
3. Realizar las operaciones matemáticas solicitadas
4. Dibuje un rectángulo en la diapositiva
5. Añade el resultado como texto dentro del rectángulo

Nota: El servidor MCP se administra internamente mediante el script del cliente, por lo que no es necesario iniciarlo manualmente. El servidor gestiona todas las operaciones matemáticas y las interacciones con Keynote, mientras que el cliente gestiona la comunicación con el modelo de lenguaje y organiza el flujo de trabajo general.

Herramientas matemáticas disponibles

• Operaciones básicas:
  • Adición ( add )
  • Resta ( subtract )
  • Multiplicación ( multiply )
  • División ( divide )
  • Poder ( power )
  • Raíz cuadrada ( sqrt )
  • Raíz cúbica ( cbrt )
• Operaciones avanzadas:
  • Factorial ( factorial )
  • Logaritmo natural ( log )
  • Resto ( remainder )
  • Funciones trigonométricas ( sin , cos , tan )
  • secuencia de Fibonacci ( fibonacci_numbers )
  • Cálculos de valores ASCII ( strings_to_chars_to_int )
  • Suma exponencial ( int_list_to_exponential_sum )

Integración de Keynote

El proyecto incluye herramientas para la integración de Keynote:

• mac_open_keynote : abre Keynote y crea un nuevo documento
• mac_draw_rectangle : Dibuja un rectángulo en la diapositiva actual
• mac_add_text_in_keynote : Agrega texto a la diapositiva actual

Manejo de errores

El sistema incluye un manejo integral de errores para:

• Problemas de comunicación de la API
• Operaciones matemáticas no válidas
• Problemas de integración de Keynote
• Manejo de tiempos de espera para respuestas LLM

Herramientas

• Protocolo de control de modelos (MCP) para el marco
• Google Gemini para el modelo de lenguaje
• Apple Keynote para la plataforma de presentaciones

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.