🧠 mcp_server-client_EAG-S-4 - Local Setup
About
# 🧠 mcp_server-client_EAG-S-4 - Local Setup This repository provides a minimal implementation to set up and interact with the **MCP (Modular Computation Protocol)** locally. It consists of a **server** that exposes various computational tools and a **client** that communicates with the server to invoke those tools…
Explore
- 28 tools including math, string/image, and Pinta automation
- Uses uv for fast dependency management and reproducibility
- Server exposes tools that a client can invoke remotely
- Includes a ready-to-use client entry point
- Pinta automation tools for drawing rectangles, circles, and text
- Image thumbnail generation and ASCII conversion tools
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
🧠 mcp_server-client_EAG-S-4 - Local SetupCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
This repository provides a minimal implementation to set up and interact with the MCP (Modular Computation Protocol) locally. It consists of a server that exposes various computational tools and a client that communicates with the server to invoke those tools.
The project is managed using uv, a fast Python package manager and workflow tool.
---
curl -Ls https://astral.sh/uv/install.sh | sh
Verify installation:
uv --version
uv venv
source .venv/bin/activate # or .venv\Scripts\activate on Windows
uv pip install -r pyproject.toml
> If requirements.txt doesn't exist:
>
>
> uv pip freeze > requirements.txt
> 1. add(a, b) — Add two numbers
2. add_list(l) — Add all numbers in a list
3. subtract(a, b) — Subtract two numbers
4. multiply(a, b) — Multiply two numbers
5. divide(a, b) — Divide two numbers
6. power(a, b) — Raise a to the power of b
7. sqrt(a) — Square root
8. cbrt(a) — Cube root
9. factorial(a) — Factorial
10. log(a) — Natural logarithm
11. remainder(a, b) — Modulus operation
12. sin(a) — Sine
13. cos(a) — Cosine
14. tan(a) — Tangent
15. mine(a, b) — Special mining tool
16. int_list_to_exponential_sum(int_list) — Sum of exponentials of integers
17. fibonacci_numbers(n) — First n Fibonacci numbers
18. strings_to_chars_to_int(string) — Convert characters to ASCII
19. create_thumbnail(image_path) — Generate a thumbnail from an image
20. open_pinta_application() — Launch and focus Pinta
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) — Return lines from rectangle coordinates
28. get_midpoint_of_line(x1, y1, x2, y2) — Return midpoint of a line
---
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\ud83e\udde0 mcp_server-client_eag-s-4 - local setup": {
"local_mcp_server-client_EAG-S-4": {
"command": "uv",
"args": [
"venv"
]
}
}
}
}McpServers
{
"local_mcp_server-client_EAG-S-4": {
"command": "uv",
"args": [
"venv"
]
}
}This repository provides a minimal implementation to set up and interact with the MCP (Modular Computation Protocol) locally. It consists of a server that exposes various computational tools and a client that communicates with the server to invoke those tools.
The project is managed using uv, a fast Python package manager and workflow tool.
---
📂 Project Structure
- mcp_server.py — Hosts the MCP server with 28 tools available for interaction.
- mcp_client.py — The entry point of the project; runs a client that connects to the MCP server and calls its tools.
- pyproject.toml — Project configuration and dependencies using PEP 621.
- uv.lock — Auto-generated lockfile for reproducible installations using uv.
- token.env — Environment file that likely contains secrets or tokens.
- README.md — Project documentation."""
---
🛠️ Available Tools on the MCP Server
🔢 Math Tools
1. add(a, b) — Add two numbers
2. add_list(l) — Add all numbers in a list
3. subtract(a, b) — Subtract two numbers
4. multiply(a, b) — Multiply two numbers
5. divide(a, b) — Divide two numbers
6. power(a, b) — Raise a to the power of b
7. sqrt(a) — Square root
8. cbrt(a) — Cube root
9. factorial(a) — Factorial
10. log(a) — Natural logarithm
11. remainder(a, b) — Modulus operation
12. sin(a) — Sine
13. cos(a) — Cosine
14. tan(a) — Tangent
15. mine(a, b) — Special mining tool
16. int_list_to_exponential_sum(int_list) — Sum of exponentials of integers
17. fibonacci_numbers(n) — First n Fibonacci numbers
🧠 String/Image Tools
18. strings_to_chars_to_int(string) — Convert characters to ASCII
19. create_thumbnail(image_path) — Generate a thumbnail from an image
🖌️ Pinta Automation Tools
20. open_pinta_application() — Launch and focus Pinta
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) — Return lines from rectangle coordinates
28. get_midpoint_of_line(x1, y1, x2, y2) — Return midpoint of a line
---
🚀 Getting Started
1. Clone the Repository
git clone https://github.com/your-username/mcp-protocol.git
cd mcp-protocol
2. Install uv (if not already installed)
curl -Ls https://astral.sh/uv/install.sh | sh
Verify installation:
uv --version
3. Set Up the Project Environment
uv venv
source .venv/bin/activate # or .venv\Scripts\activate on Windows
uv pip install -r pyproject.toml
> If requirements.txt doesn't exist:
>
>
> uv pip freeze > requirements.txt
> 4. Test MCP Server with GUI client
mcp dev mcp_server.py
5. Run the Client
python mcp_client.py
---
📌 Notes
- Ensure Pinta is installed if you're using Pinta-related tools.
- Image tools like create_thumbnail require valid image paths.
- mcp_client.py is the main entry point to interact with the protocol.
---
📄 License
MIT License. Feel free to fork, modify, and contribute.
---
🤝 Contributing
Pull requests are welcome. For major changes, please open an issue first.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
