✨ 核心功能
🔌 通用连接
- 多协议支持
- 原生支持 stdio 传输
- 服务器发送事件(SSE)用于实时通信
- Docker 容器集成
- NPX 包执行
- 可扩展的传输层以支持未来协议
🧠 AI 驱动的智能
- 高级 LLM 集成
- 无缝集成 OpenAI 模型
- 无缝集成 OpenRouter 模型
- 无缝集成 Groq 模型
- 无缝集成 Gemini 模型
- 基于可用能力的动态系统提示
- 智能上下文管理
- 自动工具选择和链式调用
- 通过自定义 ReAct Agent 实现通用模型支持
- 处理没有原生函数调用的模型
- 基于用户请求的动态函数执行
- 智能工具编排
🔒 安全与隐私
- 显式用户控制
- 所有工具执行需要用户明确批准
- 执行前清晰解释工具操作
- 透明披露数据访问和使用
- 数据保护
- 严格的数据访问控制
- 服务器特定的数据隔离
- 未经授权的数据暴露
- 隐私优先方法
- 最小化数据收集
- 用户数据保留在指定服务器上
- 未经同意不跨服务器共享数据
- 安全通信
- 加密传输协议
- 安全的 API 密钥管理
- 环境变量保护
💬 提示管理
- 高级提示处理
- 跨服务器的动态提示发现
- 灵活的参数解析(JSON 和键值格式)
- 跨服务器提示协调
- 智能提示验证
- 上下文感知的提示执行
- 实时提示响应
- 支持复杂的嵌套参数
- 自动类型转换和验证
🛠️ 工具编排
- 动态工具发现与管理
- 自动工具能力检测
- 跨服务器工具协调
- 基于上下文的智能工具选择
- 实时工具可用性更新
📦 资源管理
- 通用资源访问
- 跨服务器资源发现
- 统一资源寻址
- 自动资源类型检测
- 智能内容摘要
🔄 服务器管理
- 高级服务器处理
- 多个同时服务器连接
- 自动服务器健康监控
- 优雅的连接管理
- 动态能力更新
🚀 使用教程
使用依赖
- Python 3.10+
- LLM API 密钥
- UV 包管理器(推荐)
安装教程
```bash
使用 uv 推荐
uv add mcpomni-connect
使用 pip
pip install mcpomni-connect
```
启动 CLI
```bash
启动 CLI,确保 API 密钥已导出或创建 .env 文件
mcpomni_connect
```
调试方式
```bash
运行所有测试并输出详细信息
pytest tests/ -v
运行特定测试文件
pytest tests/test_specific_file.py -v
运行测试并生成覆盖率报告
pytest tests/ --cov=src --cov-report=term-missing
```
开发快速开始
- 安装
```bash
# 克隆仓库
git clone https://github.com/Abiorh001/mcp_omni_connect.git
cd mcp_omni_connect
# 创建并激活虚拟环境
uv venv
source .venv/bin/activate
# 安装依赖
uv sync
```
- 配置
```bash
# 设置环境变量
echo "LLM_API_KEY=your_key_here" > .env
# 在 servers_config.json 中配置服务器
```
- 启动客户端
bash
# 启动客户端
uv run src/main.py 或 python src/main.py