🧠 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 许可证。 随意 fork、修改和贡献。

---

🤝 贡献

欢迎提交 Pull Request。 对于重大更改，请先打开一个 issue。