Eagv1 S4 MCP

🚀 Math Operation Agent (Integrated with Microsoft Word and Gmail)

A Python-based math operation agent that iteratively solves problems using various math tools and visualizes results with Microsoft Word and Gmail.

✨ Features

• Mathematical Operations

  • Basic arithmetic operations (addition, subtraction, multiplication, division)
  • Advanced operations (power, square root, cube root)
  • Trigonometric functions (sine, cosine, tangent)
  • Logarithmic calculations
  • Factorial calculations
  • Fibonacci sequence generation
  • ASCII value conversion
  • Exponential sum calculations

• Artificial Intelligence Integration

  • Use Google Gemini Pro model for intelligent problem-solving
  • Iterative problem-solving approach
  • Automatic tool selection and execution

• Enhanced Logging

  • Detailed execution logs
  • Debug information for tool operations
  • Error tracking and reporting
  • Comprehensive email reports with execution history

• Email Integration

  • Automatically send email reports upon completion
  • Include detailed execution logs in the email body
  • Summary of final results
  • Gmail SMTP integration

• Word Integration

  • Automatically generate Word documents
  • Draw rectangles for results
  • Automate result visualization
  • Text position configuration

📦 Installation

Prerequisites

• Python 3.7+
• Microsoft Word on macOS
• macOS 10.15 or higher
• Google Cloud API key (for Gemini Pro)

Steps

1. Clone the repository.
2. Install dependencies:

pip3 install -r requirements.txt

3. Set environment variables:

Option 1: Export in the terminal (recommended for testing):

export GEMINI_API_KEY=your_api_key_here
export GMAIL_USER=your.email@gmail.com
export GMAIL_APP_PASSWORD=your16digitpassword

Option 2: Create a .env file:

GEMINI_API_KEY=your_api_key_here
GMAIL_USER=your.email@gmail.com
GMAIL_APP_PASSWORD=your16digitpassword

💻 Usage Examples

Basic Usage

The recommended way is to run the client (which automatically starts the server):

python math_agent_client.py

Advanced Usage

For debugging purposes (optional), run the server and client separately:

1. Start the MCP server:

# Terminal 1
python math_agent_server.py

# Terminal 2
python math_agent_client.py

The agent will:

• Start the MCP server internally.
• Process math queries using Gemini AI.
• Perform calculations with available tools.
• Create a Word document with results.
• Draw a rectangle to display the final answer.
• Send an email report with execution logs.

Example Queries

- Find the ASCII values of characters in "INDIA" and then return the sum of the exponential sums of these values.
- Calculate the factorial of 5.
- Find the sum of the first 10 Fibonacci numbers.

📚 Documentation

Architecture

• math_agent_client.py: The main client handles:

  • Gemini AI integration
  • Query processing
  • Tool execution
  • Word result visualization

• math_agent_server.py: The server provides:

  • Math tools
  • Word integration tools
  • Resource processors

Error Handling

• Timeout protection for AI generation effectiveness.
• Robust error handling for tool execution.
• Automatic status reset.
• Debug logging.

Logging

• All operations are timestamped.
• Log levels: INFO, DEBUG, ERROR.
• Logs are included in email reports.
• Console output for real-time monitoring.

Troubleshooting

Email Configuration

• Ensure that GMAIL_USER is your full email address.
• GMAIL_APP_PASSWORD must be a 16-character 'app' password.
• Enable two-factor authentication for your Google account.
• Check execution logs for detailed error information.

Word Integration

• Make sure Microsoft Word is installed and properly configured on your system.
• Check if the user running the agent has permission to access the Word installation directory.

⚠️ Important Note

This agent requires an internet connection to use the Gemini AI service.

💡 Usage Tip

It is recommended to check if all dependencies are correctly installed before the first use. If you encounter any problems, please check the log files or contact the support team.