🧠 mcp_server-client_EAG-S-4 - Local Setup

🧠 mcp_server-client_EAG-S-4 - 本地设置

此仓库提供了一个精简实现，用于在本地设置并与 MCP (Modular Computation Protocol) 交互。它由一个用于提供各种计算工具的服务和一个与服务通信并调用这些工具的客户端组成。

此项目使用 uv 管理，这是一个快速的 Python 包管理器和工作流工具。

---

📂 项目结构

• mcp_server.py — 托管 MCP 服务，提供 28 种可供交互的工具。
• mcp_client.py — 项目的入口点；运行一个连接到 MCP 服务并调用其工具的客户端。
• pyproject.toml — 使用 PEP 621 管理项目配置和依赖项。
• uv.lock — 使用 uv 自动生成的锁定文件，确保安装可复现。
• token.env — 可能包含密钥或令牌的环境文件。
• README.md — 项目文档。"""

---

🛠️ MCP 服务提供的工具

🔢 数学工具

1. add(a, b) — 将两个数字相加
2. add_list(l) — 将列表中的所有数字相加
3. subtract(a, b) — 两个数字相减
4. multiply(a, b) — 将两个数字相乘
5. divide(a, b) — 将两个数字相除
6. power(a, b) — 计算 a 的 b 次方
7. sqrt(a) — 平方根
8. cbrt(a) — 立方根
9. factorial(a) — 阶乘
10. log(a) — 自然对数
11. remainder(a, b) — 取模运算
12. sin(a) — 正弦
13. cos(a) — 余弦
14. tan(a) — 正切
15. mine(a, b) — 特殊挖掘工具
16. int_list_to_exponential_sum(int_list) — 计算整数的指数和
17. fibonacci_numbers(n) — 前 n 个斐波那契数

🧠 字符串/图像工具

18. strings_to_chars_to_int(string) — 将字符转换为 ASCII 码
19. create_thumbnail(image_path) — 根据图像生成缩略图

🖌️ Pinta 自动化工具

20. open_pinta_application() — 启动并聚焦 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) — 返回矩形坐标对应的线段
28. get_midpoint_of_line(x1, y1, x2, y2) — 返回线段的中点

---

🚀 开始使用

1. 克隆仓库

git clone https://github.com/your-username/mcp-protocol.git
cd mcp-protocol

2. 安装 uv（如果尚未安装）

curl -Ls https://astral.sh/uv/install.sh | sh

验证安装：

uv --version

3. 设置项目环境

uv venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
uv pip install -r pyproject.toml

如果不存在 requirements.txt：

uv pip freeze > requirements.txt

4. 使用 GUI 客户端测试 MCP 服务

mcp dev mcp_server.py

5. 运行客户端

python mcp_client.py

---

📌 备注

• 如果要使用 Pinta 相关工具，请确保已安装 Pinta。
• create_thumbnail 等图像工具需要有效的图像路径。
• mcp_client.py 是与该协议交互的主要入口点。

---

📄 许可证

MIT 许可证。欢迎复刻、修改和贡献。

---

🤝 参与贡献

欢迎提交拉取请求。对于重大更改，请先创建问题。