MCP Math Gmail Client

The Math Gmail Client (`talk2mcp_math_gmail_client.py`) is a Python application that integrates mathematical computations with Gmail functionality. It uses the Gemini AI model to process mathematical queries and can send results via email.

Features

• Integration with Gemini AI for mathematical problem-solving
• Gmail integration for sending mathematical results
• Iterative problem-solving approach
• Support for various mathematical operations
• Automated email generation with mathematical results
• Secure Gmail authentication
• Multiple recipient support

Server Requirements

1. MCP Server Setup:

Prerequisites

• Python 3.x
• Required Python packages:
  • `python-dotenv`
  • `google-generativeai`
  • `mcp` package
  • `google-auth`
  • `google-auth-oauthlib`
  • `google-auth-httplib2`
  • `google-api-python-client`

Environment Setup

1. Create a `.env` file in the project root

2. Add your API keys:

GEMINI_API_KEY=your_api_key_here
   GMAIL_CLIENT_ID=your_client_id_here
   GMAIL_CLIENT_SECRET=your_client_secret_here

Server Setup

1. Install server dependencies:

pip install mcp numpy pandas matplotlib

2. Start the MCP server:

python example2-3_gmail_server_2.py

Available Tools

Currently Implemented Tools

1. Mathematical Operations:

2. Email Tools:

Installation

1. Clone the repository

2. Install required packages:

pip install python-dotenv google-generativeai mcp google-auth google-auth-oauthlib google-auth-httplib2 google-api-python-client

3. Set up your environment variables as described above

4. Set up Gmail API credentials:

Usage

1. Start the MCP server (see Server Setup section)

2. Ensure the server is running and accessible

3. Run the client:

python talk2mcp_math_gmail_client.py

Server-Client Communication

1. Connection Protocol:

2. Data Flow:

3. Error Handling:

Example Queries

1. Basic Mathematical Email:

Calculate the factorial of 10 and send the result to user@example.com with the subject "Factorial Calculation Result".

2. Complex Mathematical Analysis:

Find the first 50 Fibonacci numbers, calculate their sum, and send the detailed analysis to team@example.com with a graph attachment.

3. Multiple Operations with Formatting:

Calculate the roots of the quadratic equation x² + 5x + 6 = 0, format the solution in LaTeX, and send it to professor@example.com with proper mathematical notation.

4. Scheduled Mathematical Report:

Generate a report of prime numbers between 1 and 1000, create a histogram of their distribution, and schedule it to be sent to research@example.com tomorrow at 9:00 AM.

How It Works

1. The client connects to the MCP server

2. It processes mathematical queries using the Gemini AI model

3. Results are formatted for email

4. The system uses an iterative approach to solve complex problems

5. Results are sent via Gmail to specified recipients

Error Handling

The client includes robust error handling for:

• API timeouts
• Invalid inputs
• Connection issues
• Tool execution errors
• Gmail authentication and sending errors

Security

• Uses OAuth 2.0 for Gmail authentication
• Secure storage of API keys and credentials
• Encrypted communication with Gmail API

Contributing

Feel free to submit issues and enhancement requests.

License

Licensed under the Apache License, Version 2.0 (the "License");

you may not use this file except in compliance with the License.

You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software

distributed under the License is distributed on an "AS IS" BASIS,

WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

See the License for the specific language governing permissions and

limitations under the License.

Troubleshooting

1. Common Issues:

2. Solutions:

Performance Tips

1. Optimization:

2. Best Practices: