BinRag

外观

BinRag文档 RAG 知识库问答系统

多格式文档 → 混合检索 → 带引用来源的智能问答。开箱即用的 MCP Server 与 OIDC 登录，让文档资产真正可对话、可调用。

快速开始
MCP Server

核心能力 ​

多格式解析

TXT / Markdown / PDF / DOCX / CSV / Excel / HTML，统一结构化后入库

混合检索

向量语义 + BM25 关键词，RRF 加权融合，兼顾理解与精确

重排序精排

Cross-encoder 重排序（Jina / Cohere / bge-reranker），提升最终召回质量

流式问答

SSE 流式输出，引用来源先行、正文增量返回

异步入库

上传即返回任务 ID，后台 worker 池执行，失败自动/手动重试

双通道认证

API Key（SHA-256）+ OIDC / GitHub 三方登录，会话 JWT

MCP Server

streamable HTTP 开放 6 个只读 Tool，外部 Agent 直接调用

Web + 桌面

浏览器即用；Wails 打包 macOS 安装包，同一套前端

架构一览 ​

接入层
Web 前端Vue 3 SPA
桌面应用Wails v3
外部 AgentMCP Client
↓
API / MCP
REST API知识库 / 文档 / 问答 / 认证
MCP Serverstreamable HTTP · 6 个只读 Tool
↓
能力链路
入库链路Load → Chunk → Embed → Store
问答链路改写 → 混合检索(RRF) → 重排序 → LLM
Qdrant 向量库BM25 索引PostgreSQL 元数据

能力亮点 ​

MCP Server

让 RAG 能力被任意 Agent 调用

  • streamable HTTP 单端点，initialize → tools/list → tools/call 标准握手
  • API Key 认证（401）与 Tool / 知识库授权（-32001），不泄露资源存在性
  • 系统级 Key 全量权限；登录用户在「我的 MCP」自助生成绑定自己的凭据
  • 双层开关：全局部署级 + 用户级，调用审计异步落库
OIDC 登录

企业级身份接入

  • 任意符合规范的 OIDC Provider + GitHub OAuth2，多 Provider 并存
  • 登录后签发会话 JWT，用户拥有独立的知识库归属
  • 「我的 MCP」凭据绑定登录用户，知识库范围限于自己的知识库
  • 与系统级 API Key 双通道并存，接口权限严格隔离

快速上手 ​

1
配置模型与密钥

deploy/configs/config.docker.yaml 填入 Embedding / LLM 模型地址与 bootstrap API Key

2
一键 Docker 启动

docker compose up -d --build — 构建镜像并启动 PostgreSQL + Qdrant + binrag-server

3
浏览器访问 8085

http://localhost:8085 — 输入 API Key 登录使用（免编译可拉取 ghcr.io 镜像）

技术栈 ​

Go 1.26 Gin Qdrant PostgreSQL Vue 3 Wails v3 MCP (streamable HTTP)

前往 快速开始 开始使用，或查阅 MCP Server 与 登录认证 专项文档。