What is Mcp Math Macos

mcp-math-macos is a project that implements a math agent using Model Control Protocol (MCP) to perform mathematical calculations and visually present the results in Keynote on macOS.

Use cases

Use cases include generating mathematical presentations, visualizing complex calculations, and automating the creation of Keynote slides with mathematical content.

How to use

To use mcp-math-macos, clone the repository, install the required dependencies, set up your Gemini API key, and run the client script with your mathematical query.

Key features

Key features include basic mathematical operations (addition, subtraction, multiplication, division), advanced functions (factorial, logarithms, trigonometric functions), ASCII value calculations, and visual presentations in Keynote with drawing and text addition.

Where to use

mcp-math-macos can be used in educational settings for teaching mathematics, in professional environments for creating mathematical presentations, and in research for visualizing mathematical data.

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:

git clone <your-repository-url>
cd keynote-drawing-text

2. Install required dependencies:

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:

python mcp-client.py "Your mathematical query here"

For example:

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.