项目简介

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等传输协议

安装步骤

  1. 创建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"]

基本使用方法

  1. 配置环境变量:'export OLLAMA_BASE_URL=<your_Ollama_server>'
  2. 启动后端服务器:'soliplex-cli serve example/minimal.yaml --no-auth-mode'
  3. 访问MCP端点:服务器启动后,可通过"/mcp/<room_id>"路径访问对应房间的MCP服务器功能
  4. MCP客户端可连接到指定的房间端点,使用文档搜索、工具调用等功能

信息

分类

数据库与文件