mcp-math-macos

# 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: ```bash git clone <your-repository-url> cd keynote-drawing-text ``` 2. Install required dependencies: ```bash pip install -r requirements.txt ``` 3. Create a `.env` file in the project root and add your Gemini API key: ``` GEMINI_API_KEY=your_api_key_here ``` ## 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: ```bash python mcp-client.py "Your mathematical query here" ``` For example: ```bash python mcp-client.py "Find the ASCII values of characters in INDIA and then return sum of exponentials of those values" ``` 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.