Introduction to MCP; Draw & Add Text to Keynote on MacOS

This project implements a math agent using Model Control Protocol (MCP) that can perform mathematical calculations and present results visually in Keynote on macOS. The agent can draw shapes and add text to Keynote slides, making it useful for creating mathematical presentations.

Features

• Mathematical operations (addition, subtraction, multiplication, division, etc.)

• Advanced mathematical functions (factorial, logarithms, trigonometric functions)

• ASCII value calculations and exponential sum operations

• Visual presentation in Keynote:

  • Drawing rectangles

  • Adding text to slides

  • Automatic slide management

Prerequisites

• Python 3.x

• macOS (for Keynote integration)

• Keynote installed on your system

• Google Gemini API key

Installation

1. Clone the repository:

2. Install required dependencies:

3. Create a .env file in the project root and add your Gemini API key:

Project Structure

• mcp-server.py: Contains the server implementation with mathematical tools and Keynote integration

• mcp-client.py: Implements the client that communicates with the LLM and manages the workflow

• requirements.txt: Lists all Python dependencies

Usage

The client script (mcp-client.py) automatically handles the MCP server startup and communication. You only need to run the client with your query:

For example:

If no query is provided, the script will use a default query mentioned in the above example.

The client will:

1. Automatically start the MCP server in the background

2. Open Keynote and create a new document

3. Perform the requested mathematical operations

4. Draw a rectangle on the slide

5. Add the result as text within the rectangle

Note: The MCP server is managed internally by the client script, so you don't need to start it manually. The server handles all the mathematical operations and Keynote interactions, while the client manages the communication with the language model and orchestrates the overall workflow.

Available Mathematical Tools

• Basic Operations:

  • Addition (add)

  • Subtraction (subtract)

  • Multiplication (multiply)

  • Division (divide)

  • Power (power)

  • Square root (sqrt)

  • Cube root (cbrt)

• Advanced Operations:

  • Factorial (factorial)

  • Natural logarithm (log)

  • Remainder (remainder)

  • Trigonometric functions (sin, cos, tan)

  • Fibonacci sequence (fibonacci_numbers)

  • ASCII value calculations (strings_to_chars_to_int)

  • Exponential sum (int_list_to_exponential_sum)

Keynote Integration

The project includes tools for Keynote integration:

• mac_open_keynote: Opens Keynote and creates a new document

• mac_draw_rectangle: Draws a rectangle on the current slide

• mac_add_text_in_keynote: Adds text to the current slide

Error Handling

The system includes comprehensive error handling for:

• API communication issues

• Invalid mathematical operations

• Keynote integration problems

• Timeout handling for LLM responses

Tools

• Model Control Protocol (MCP) for the framework

• Google Gemini for the language model

• Apple Keynote for the presentation platform

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.