LLM Gateway

🚀 模型上下文協議（MCP）——通用多功能代理服務器

模型上下文協議（MCP）是一個通用多功能代理服務器，它提供了豐富的工具列表，支持多種運行模式，同時注重安全性。通過簡單的安裝和啟動步驟，用戶可以快速使用該服務器進行文件處理、數據解析、網絡請求等操作。

🚀 快速開始

📦 安裝指南

安裝依賴項：

uv sync && uv pip install --upgrade .

💻 啟動服務器

umcp run

# 或者以 SSE 模式運行：
umcp run --transport-mode sse

🚀 運行服務器

默認模式

啟動默認的控制檯模式：

umcp run

SSE 模式

通過 SSE（Server-Sent Events）模式運行服務器，適用於 web 和遠程客戶端連接：

# 啟動 SSE 模式的服務器：
umcp run --transport-mode sse

# 或使用快捷方式：
umcp run -t sse

# 設置自定義主機和端口：
umcp run -t sse --host 0.0.0.0 --port 8080

✨ 主要特性

💻 工具列表

文件系統工具

• file_system.read_file：讀取文件內容並返回其內容。
• file_system.write_file：將內容寫入指定文件，支持覆蓋和追加模式。

數據處理工具

• json_parser.parse_json：解析 JSON 格式的數據。
• csv_processor.process_csv：處理 CSV 文件，提取或轉換數據。

網絡請求工具

• http_request.get：發送 GET 請求並獲取響應內容。
• http_request.post：發送 POST 請求，並可傳遞自定義頭和正文內容。

命令行工具

• cli_parser.run_command：執行命令行指令，返回輸出結果。

🔧 技術細節

🔒 安全注意事項

依賴項管理

定期更新第三方庫以修復已知漏洞：

uv pip install --upgrade .

輸入驗證與淨化

對所有用戶輸入進行嚴格驗證和淨化處理，防止惡意攻擊和注入。

最小權限原則

確保服務器進程運行在最低權限級別，並限制文件系統訪問目錄。

📄 許可證

本項目使用 MIT 許可證。詳細信息請查看 LICENSE 文件。

👏 致謝

感謝以下開源項目和社區：

• Model Context Protocol (MCP) 提供基礎概念。
• FastAPI 團隊開發的高性能 Web 框架。
• Pydantic 開發者提供的數據驗證工具。
• Rich 庫用於美化終端輸出。
• uv 提供高效的依賴管理。

感謝所有貢獻者的辛勤工作！