🚀 MCPOmni Connect - Universal Gateway to MCP Servers

✨ 核心功能

🔌 通用连接

• 多协议支持
• 原生支持 stdio 传输
• 服务器发送事件（SSE）用于实时通信
• Docker 容器集成
• NPX 包执行
• 可扩展的传输层以支持未来协议

🧠 AI 驱动的智能

• 高级 LLM 集成
• 无缝集成 OpenAI 模型
• 无缝集成 OpenRouter 模型
• 无缝集成 Groq 模型
• 无缝集成 Gemini 模型
• 基于可用能力的动态系统提示
• 智能上下文管理
• 自动工具选择和链式调用
• 通过自定义 ReAct Agent 实现通用模型支持
  • 处理没有原生函数调用的模型
  • 基于用户请求的动态函数执行
  • 智能工具编排

🔒 安全与隐私

• 显式用户控制
• 所有工具执行需要用户明确批准
• 执行前清晰解释工具操作
• 透明披露数据访问和使用
• 数据保护
• 严格的数据访问控制
• 服务器特定的数据隔离
• 未经授权的数据暴露
• 隐私优先方法
• 最小化数据收集
• 用户数据保留在指定服务器上
• 未经同意不跨服务器共享数据
• 安全通信
• 加密传输协议
• 安全的 API 密钥管理
• 环境变量保护

💬 提示管理

• 高级提示处理
• 跨服务器的动态提示发现
• 灵活的参数解析（JSON 和键值格式）
• 跨服务器提示协调
• 智能提示验证
• 上下文感知的提示执行
• 实时提示响应
• 支持复杂的嵌套参数
• 自动类型转换和验证

🛠️ 工具编排

• 动态工具发现与管理
• 自动工具能力检测
• 跨服务器工具协调
• 基于上下文的智能工具选择
• 实时工具可用性更新

📦 资源管理

• 通用资源访问
• 跨服务器资源发现
• 统一资源寻址
• 自动资源类型检测
• 智能内容摘要

🔄 服务器管理

• 高级服务器处理
• 多个同时服务器连接
• 自动服务器健康监控
• 优雅的连接管理
• 动态能力更新

🚀 使用教程

使用依赖

• Python 3.10+
• LLM API 密钥
• UV 包管理器（推荐）

安装教程

# 使用 uv 推荐
uv add mcpomni-connect
# 使用 pip
pip install mcpomni-connect

启动 CLI

# 启动 CLI，确保 API 密钥已导出或创建 .env 文件
mcpomni_connect

调试方式

# 运行所有测试并输出详细信息
pytest tests/ -v

# 运行特定测试文件
pytest tests/test_specific_file.py -v

# 运行测试并生成覆盖率报告
pytest tests/ --cov=src --cov-report=term-missing

开发快速开始

1. 安装 ```bash # 克隆仓库 git clone https://github.com/Abiorh001/mcp_omni_connect.git cd mcp_omni_connect

# 创建并激活虚拟环境 uv venv source .venv/bin/activate

# 安装依赖 uv sync ```

1. 配置 ```bash # 设置环境变量 echo "LLM_API_KEY=your_key_here" > .env

# 在 servers_config.json 中配置服务器 ```

1. 启动客户端 bash # 启动客户端 uv run src/main.py 或 python src/main.py

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。