Local MCP Server Client EAG S 4

🚀 mcp_server-client_EAG-S-4 - Local Setup Guide

This repository provides a minimal implementation for setting up and interacting with the Modular Computing Protocol (MCP) locally. It includes a server that exposes various computing tools and a client for communicating with the server to invoke these tools.

The project is managed using uv, a fast Python package management and workflow tool.

🚀 Quick Start

This project offers a minimal implementation for local setup and interaction with the Modular Computing Protocol (MCP). It includes a server that exposes various computing tools and a client for communicating with the server to invoke these tools.

✨ Features

• Server and Client: The project contains a server that exposes various computing tools and a client for communicating with the server to invoke these tools.
• Tool Management: The server provides 28 available tools for interaction, covering mathematical, string/image, and Pinta automation tools.
• Package Management: The project is managed using uv, a fast Python package management and workflow tool.

📦 Installation

Step 1: Clone the Repository

Clone the project repository to your local machine using the following command:

git clone https://github.com/your-username/mcp_server-client_EAG-S-4.git

Step 2: Install Dependencies

Navigate to the project directory and install all dependencies:

cd mcp_server-client_EAG-S-4
pip install -r requirements.txt

Step 3: Start the Server

Run the following command to start the MCP server:

python mcp_server.py

Step 4: Use the Client

Run the following command to start the MCP client:

python mcp_client.py

📚 Documentation

📂 Project Structure

• mcp_server.py — Hosts the MCP server, providing 28 available tools for interaction.
• mcp_client.py — The entry point of the project; runs a client to connect to the MCP server and invoke its tools.
• pyproject.toml — Project configuration and dependencies, using the PEP 621 format.
• uv.lock — An automatically generated lock file for reproducible installations.
• token.env — An environment file that may contain keys or tokens.
• README.md — Project documentation.

🛠️ Available Tools on the Server

🔢 Mathematical Tools

1. add(a, b) — Adds two numbers.
2. add_list(l) — Calculates the sum of all numbers in a list.
3. subtract(a, b) — Subtracts two numbers.
4. multiply(a, b) — Multiplies two numbers.
5. divide(a, b) — Divides two numbers.
6. power(a, b) — Raises a to the power of b.
7. sqrt(a) — Calculates the square root.
8. cbrt(a) — Calculates the cube root.
9. factorial(a) — Calculates the factorial.
10. log(a) — Natural logarithm.
11. remainder(a, b) — Modulo operation.
12. sin(a) — Sine function.
13. cos(a) — Cosine function.
14. tan(a) — Tangent function.
15. mine(a, b) — Special mining tool.
16. int_list_to_exponential_sum(int_list) — Exponential sum of an integer list.
17. fibonacci_numbers(n) — The first n Fibonacci numbers.

🧠 String/Image Tools

18. strings_to_chars_to_int(string) — Converts characters to ASCII numbers.
19. create_thumbnail(image_path) — Generates a thumbnail from an image.

🖌️ Pinta Automation Tools

20. open_pinta_application() — Launches and focuses on the Pinta application.
21. select_rectangle_tool()
22. select_text_tool()
23. select_circle_tool()
24. draw_rectangle(x1, y1, x2, y2)
25. write_text_inside_rectangle(text, x1, y1, x2, y2)
26. draw_circle(x1, y1, radius)
27. get_lines_of_rectangle(x1, y1, x2, y2) — Returns the lines of rectangle coordinates.
28. get_midpoint_of_line(x1, y1, x2, y2) — Returns the midpoint of a line segment.

⚠️ Important Note

• Ensure that you have installed the latest version of Python (3.8 or higher).
• Make sure the uv tool is installed before installation.
• If you encounter any issues during use, please refer to the project documentation or contact the maintainers.

💡 Usage Tip

If you wish to contribute to this project, please follow these steps:

1. Fork this repository.
2. Create a new feature branch: git checkout -b feature/your-feature-name
3. Commit your changes: git commit -m 'Added a new feature'
4. Push to your forked repository: git push origin feature/your-feature-name
5. Create a pull request.

📧 Contact

If you have any questions or feedback, please contact the project maintainers via the following methods:

• Email: [Your Email Address]
• GitHub: [Your GitHub Username]

Thank you for using the MCP protocol! We look forward to your contributions and feedback.