MedXpert 图书馆连接器（通用版）

io.github.zhaoxinghua09-cell由 GitHub 账号 zhaoxinghua09-cell 发布v1.0.0更新于 Nov 10, 2026

Local RAG MCP server for your own .md knowledge base: BM25 + local Ollama, offline, zero egress.

已验证STDIO仅桌面知识与记忆AI 与机器学习

概览

AI 生成的概览

把你自己的 Markdown wiki 变成本地离线知识库，让助手做语义检索，并用 RAG 给出带引用的问答。

可以做什么
  • 对知识库做语义检索，返回相关片段与相似度
  • 按标题读取单个 wiki 页面的全文
  • 查看库范围：页数、分类与索引状态
  • 用本地生成模型回答问题，并附上来源引用
适用场景
适合把文档、笔记或标准资料以 Markdown 形式保存，并希望助手在不把内容发往外部服务的前提下检索和作答的场景。也适合可离线、对隐私敏感且能接受本地模型的环境。
运行要求
以本地 stdio 进程在桌面运行，纯 Python 标准库实现，无第三方依赖。需要本机 Ollama，并拉取嵌入模型（默认 bge-m3），问答还需生成模型（默认 qwen2.5:7b）。需先构建向量索引。可选环境变量：LIBRARY_WIKI_DIR、OLLAMA_BASE_URL、LIBRARY_EMBED_MODEL、LIBRARY_GEN_MODEL。
安装前请注意
包内 wiki 目录只有示例页面，需替换为你自己的文档并重建索引。回答质量取决于你拉取的本地模型。发布者声明不对知识库内容负责，请自行审核所索引的内容。

安装

在 SourceWeft 中

  1. 打开 控制台中的 MedXpert 图书馆连接器（通用版），将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

MedXpert 图书馆（通用版）连接器

把**你自己的 wiki（.md 文档）**做成可语义检索、可 RAG 问答的本地知识库 MCP 连接器。

  • 纯 Python 标准库实现（stdio JSON-RPC 2.0），零第三方依赖
  • 仅依赖本地 Ollama 做嵌入/生成，零积分、断网可用
  • 知识库为你自有文档，连接器不绑定任何预置私有数据
  • 全部计算在本机完成，不访问任何外部网络，不上传任何数据

工具

工具说明
search_knowledge(query, top_k?)语义检索知识库，返回相关片段 + 相似度
get_page(title)读取单个 wiki 页全文
list_sources()库范围：页数 / 分类 / 索引状态
ask_knowledge(question, top_k?)RAG 问答：检索 + 本地生成模型，附引用

快速开始

bash
# 1. 安装并启动 Ollama，拉取模型ollama pull bge-m3            # 检索必备（嵌入）ollama pull qwen2.5:7b        # 问答可选（生成）
# 2. 用你自己的文档替换 wiki/（本包自带 3 个示例页）#    把 .md 放进 wiki/ 即可，可建子目录分类
# 3. 构建向量索引python rag_engine.py build
# 4. 启动 MCP server（stdio）python medxpert_library_server.py

接入 WorkBuddy

包内 mcp.json 已提供标准配置；在开放平台或客户端中引用本包目录即可。 也可用环境变量覆盖默认行为：

变量默认值说明
LIBRARY_WIKI_DIR本包 wiki/知识库目录（指向你的文档）
OLLAMA_BASE_URLhttp://127.0.0.1:11434Ollama 地址
LIBRARY_EMBED_MODELbge-m3嵌入模型
LIBRARY_GEN_MODELqwen2.5:7b生成模型（问答）

包结构

medxpert-library-connector/├── medxpert_library_server.py   # MCP server（stdio，纯标准库）├── rag_engine.py                # 嵌入 / 余弦 / 构建 / 检索引擎├── wiki/                        # 示例知识库（替换成你自己的 .md）├── connector-meta.json          # 开放平台元数据├── mcp.json                     # MCP 启动配置├── icon.svg                     # 头像├── LICENSE                  # Apache-2.0├── requirements.txt             # 依赖说明（仅 Ollama）└── README.md

合规与隐私

  • 不内嵌受版权保护的标准正文，仅索引标准号与公开要点。
  • 所有内容在本机处理，文档与查询均不上传外部服务。
  • 知识库为使用者自有内容，发布者不对其内容负责。

许可说明 · License Notice

  • 代码许可：本仓库源代码以 Apache-2.0 许可发布（见根目录 LICENSE）。 © 2026 赵兴华 / Steven Zhao (ORCID 0009-0001-0512-1237). All rights reserved.
  • 内容权属：本仓库不捆绑专有知识库；随附示例内容仅供演示，归其原始所有者所有。代码以 Apache-2.0 许可发布。
  • 品牌状态限定：MedXpert、SynomosAI、LGD 等为相关项目标识，均未申请实体注册、未申请商标注册；出现仅作来源标识，不构成对法人实体或商标权的任何主张。
  • 免责：本仓库内容不构成法规意见、法律意见或注册代理服务；关键数据以监管机构最新发布为准。
  • 联系：[email protected] ｜ ORCID 0009-0001-0512-1237

mcp-name: io.github.zhaoxinghua09-cell/medxpert-library-connector

来源：README.md，提交 878c504

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 28, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。