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 提供高效的依赖管理。

感谢所有贡献者的辛勤工作！