项目简介
Soliplex 是一个基于FastAPI构建的现代化RAG系统,不仅提供Web界面和终端界面,还实现了完整的Model Context Protocol (MCP) 服务器功能,允许将各个聊天房间作为独立的MCP服务器对外提供服务。
主要功能点
- MCP服务器集成:基于FastMCP框架实现,可将聊天房间配置为MCP服务器端点
- 多房间架构:每个房间可以独立配置知识库、工具集和AI代理
- 工具调用能力:支持注册和执行多种工具供LLM调用
- RAG文档搜索:基于LanceDB向量数据库的语义检索功能
- AI代理系统:集成多种LLM提供商(OpenAI、Ollama等)
- 认证安全:支持OIDC企业单点登录和令牌验证
- 实时通信:WebSocket支持实现流式对话
- 多协议支持:支持Stdio、SSE和WebSocket等传输协议
安装步骤
- 创建Python虚拟环境:
python3.13 -m venv venv source venv/bin/activate pip install -e .
服务器配置
Soliplex的MCP服务器配置通过YAML文件定义,主要包含以下参数:
- server_name: 服务器标识名称
- command: "soliplex-cli" (主命令行工具)
- args: ["serve", "example/minimal.yaml", "--no-auth-mode"]
配置示例(JSON格式):
{ "mcp_servers": { "haiku": { "command": "soliplex-cli", "args": ["serve", "example/minimal.yaml", "--no-auth-mode"]
基本使用方法
- 配置环境变量:'export OLLAMA_BASE_URL=<your_Ollama_server>'
- 启动后端服务器:'soliplex-cli serve example/minimal.yaml --no-auth-mode'
- 访问MCP端点:服务器启动后,可通过"/mcp/<room_id>"路径访问对应房间的MCP服务器功能
- MCP客户端可连接到指定的房间端点,使用文档搜索、工具调用等功能
信息
分类
数据库与文件