EAGS4 MCP Server Client

🚀 Multi-Component Platform (MCP) Server Integration with Gemini AI

This project implements a Multi-Component Platform (MCP) server integrated with Gemini AI capabilities, enabling users to perform various mathematical operations and complex tasks through natural language instructions.

🚀 Quick Start

The Multi-Component Platform (MCP) server integrated with Gemini AI allows users to interact with the system using natural language. Here's how to get started:

Prerequisites

• Python 3.8 or higher
• Google Gemini API key
• macOS (for Keynote integration)

Installation

1. Clone the repository:

git clone https://github.com/your-repository.git

2. Create and activate a virtual environment (Python 3.8+ recommended):

python -m venv mcp-venv
source mcp-venv/bin/activate  # Use `mcp-venv\Scripts\activate` on Windows

3. Install dependencies:

pip install -r requirements.txt

Starting the Server and Client

• Start the server:

python server.py

• Start the client:

python client.py

✨ Features

Mathematical Operations

• Basic Arithmetic: Addition, subtraction, multiplication, division.
• Advanced Mathematics: Powers, square roots, cube roots.
• Special Functions: Factorials, logarithms, trigonometric functions.
• List Operations: Summing lists, exponential sums.

String Processing

• Convert strings to ASCII values.
• Process character arrays.

Keynote Integration

• Open the Keynote application.
• Draw rectangles of custom sizes.
• Add text to shapes.

AI-Driven Task Execution

• Use Gemini AI for natural language processing.
• Iteratively solve problems.
• Automatically select tools based on user queries.

💻 Usage Examples

Basic Usage

Example Queries

• Calculation: What is the sum of 10 and 20?
• Conversion: Convert "Hello, World!" to ASCII.
• Drawing a Rectangle:

{
    "action": "draw_rectangle",
    "params": {
        "width": 500,
        "height": 300
    }
}

Available Tools

Math Tools

• add: Calculate the sum of two numbers.
• subtract: Calculate the difference between two numbers.
• multiply: Calculate the product of two numbers.
• divide: Calculate the quotient of two numbers.

String Tools

• to_ascii: Convert a string to ASCII representation.
• reverse: Reverse a given string.
• uppercase: Convert a string to uppercase.

📚 Documentation

Project Structure

mcp-server/
├── server.py          # Main MCP server program
├── tools/            # Directory for integrated tools
│   ├── math_tool.py  # Mathematical operation tool
│   └── string_tool.py# String processing tool
└── requirements.txt  # List of project dependencies

Demo Video

Error Handling

The system provides the following error handling mechanisms:

• AI response timeout detection.
• Type conversion validation.
• Tool availability check.
• Parameter validity verification.

Debug Information

Debug output includes:

• Tool execution details.
• Parameter processing flow.
• Result formatting steps.
• Error messages and stack traces.

🔧 How to Contribute

1. Fork the repository.
2. Create a feature branch.
3. Commit your changes.
4. Push to the branch.
5. Create a pull request.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

🙏 Acknowledgments

Thanks to the following for their support:

• Google Gemini AI for natural language processing capabilities.
• MCP framework for tool management functionality.
• The Python community for various libraries.