Local MCP Server Client EAG S 4

🚀 🧠 mcp_server-client_EAG-S-4 - 本地設置指南

本項目提供了一個最小化的實現方案，用於在本地環境中設置並與MCP（模塊化計算協議）進行交互。項目包含一個服務器，它公開了多種計算工具；同時還有一個客戶端，可與服務器通信以調用這些工具。項目藉助uv進行管理，這是一款高效的Python包管理與工作流工具。

🚀 快速開始

安裝依賴

# 克隆項目倉庫
git clone https://github.com/your-username/mcp_server-client_EAG-S-4.git
# 進入項目目錄
cd mcp_server-client_EAG-S-4
# 安裝依賴項
pip install -r requirements.txt

啟動服務

# 啟動MCP服務器
python mcp_server.py
# 啟動MCP客戶端
python mcp_client.py

✨ 主要特性

• 提供了一個完整的本地環境，用於與MCP進行交互。
• 服務器端公開了多種計算工具，涵蓋數學、字符串/圖像、Pinta自動化等多個領域。
• 使用uv工具進行項目管理，確保項目的高效運行。

📦 安裝指南

步驟 1: 克隆倉庫

使用以下命令將項目倉庫克隆到本地計算機：

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

步驟 2: 安裝依賴項

進入項目目錄並安裝所有依賴項：

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

步驟 3: 啟動服務器

運行以下命令啟動MCP服務器：

python mcp_server.py

步驟 4: 使用客戶端

運行以下命令啟動MCP客戶端：

python mcp_client.py

📚 詳細文檔

📂 項目結構

• mcp_server.py：作為MCP服務器的核心，提供28個可用工具供用戶交互。
• mcp_client.py：項目的入口文件，運行客戶端以連接到MCP服務器並調用其工具。
• pyproject.toml：項目配置和依賴項文件，採用PEP 621格式。
• uv.lock：自動生成的鎖定文件，確保項目的可重複安裝。
• token.env：環境文件，可能包含密鑰或令牌等敏感信息。
• README.md：項目文檔，為用戶提供詳細的使用說明。

🛠️ 服務器上的可用工具

🔢 數學工具

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)：計算數字a的平方根。
8. cbrt(a)：計算數字a的立方根。
9. factorial(a)：計算數字a的階乘。
10. log(a)：計算數字a的自然對數。
11. remainder(a, b)：執行求模運算。
12. sin(a)：計算數字a的正弦值。
13. cos(a)：計算數字a的餘弦值。
14. tan(a)：計算數字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)：返回線段的中點。

🚨 注意事項

⚠️ 重要提示

• 請確保安裝了最新的Python版本（3.8或更高）。
• 安裝前需確保已安裝uv工具。
• 使用過程中若遇到任何問題，請查看項目文檔或聯繫維護人員。

📋 貢獻指南

如果您希望為該項目貢獻力量，請遵循以下步驟：

1. 叉這個倉庫。
2. 創建一個新的功能分支：git checkout -b feature/your-feature-name
3. 提交您的更改：git commit -m '添加了新的功能'
4. 推送到叉倉：git push origin feature/your-feature-name
5. 創建拉取請求。

📧 聯繫方式

如果您有任何問題或反饋，請通過以下方式聯繫項目維護人員：

• 郵箱：[你的郵箱地址]
• GitHub：[你的GitHub用戶名]

感謝您使用MCP協議！我們期待您的貢獻和反饋。