MedXpert Library Connector
Turn your own wiki (plain .md documents) into a locally searchable, RAG-capable MCP server.
- Pure Python standard library (stdio JSON-RPC 2.0) — no third-party runtime dependency
- Embedding and generation run on local Ollama — no API keys, works offline
- The knowledge base is your own documents; only a three-page sample wiki is bundled
- Everything runs on your machine; the server makes no external network call
| Tool | What it does |
|---|---|
search_knowledge(query, top_k?) |
Semantic search over your wiki; snippets with similarity |
get_page(title) |
Full text of one wiki page |
list_sources() |
Library scope: page count, categories, index status |
ask_knowledge(question, top_k?) |
RAG answer: retrieval + local generation model, with citations |
pip install medxpert-library-connector # or: uvx medxpert-library-connector
LIBRARY_WIKI_DIR=/path/to/your/wiki medxpert-library-connector
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 问答:检索 + 本地生成模型,附引用 |
快速开始
# 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_URL |
http://127.0.0.1:11434 |
Ollama 地址 |
LIBRARY_EMBED_MODEL |
bge-m3 |
嵌入模型 |
LIBRARY_GEN_MODEL |
qwen2.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 等为相关项目标识,均未申请实体注册、未申请商标注册;出现仅作来源标识,不构成对法人实体或商标权的任何主张。
- 免责:本仓库内容不构成法规意见、法律意见或注册代理服务;关键数据以监管机构最新发布为准。
- 联系:zhaoxinghua09@gmail.com | ORCID 0009-0001-0512-1237
mcp-name: io.github.zhaoxinghua09-cell/medxpert-library-connector
Metadata
Release files for medxpert-library-connector 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| medxpert_library_connector-1.0.1.tar.gz | 21.8 kB | Without provenance | Details for medxpert_library_connector-1.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| medxpert_library_connector-1.0.1-py3-none-any.whl | Python 3 | none | any | Details for medxpert_library_connector-1.0.1-py3-none-any.whl |
Total release size: 43.5 kB
Release files / medxpert_library_connector-1.0.1.tar.gz
| Download URL | medxpert_library_connector-1.0.1.tar.gz |
|---|---|
| Size | 21.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7093c68187c01799176cb924b03f4f7952d611bae00df3ea046801bb3c3dacc2
|
|
BLAKE2b-256 checksum How to use checksums |
dc348bfe968ba42b0d6c20a346263013515025bc04d1962a2f9144efb028f222
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.4 {"installer":{"name":"uv","version":"0.12.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / medxpert_library_connector-1.0.1-py3-none-any.whl
| Download URL | medxpert_library_connector-1.0.1-py3-none-any.whl |
|---|---|
| Size | 21.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0b691f304e2497f201f71fd311555bf2e5f0e16bccd739c86f2e3a22145e7432
|
|
BLAKE2b-256 checksum How to use checksums |
20cfb0f9007bf2f17d4fcf5e595aa58069e3d34001ebcbf316e142f67efb4914
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.4 {"installer":{"name":"uv","version":"0.12.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for medxpert-library-connector 1.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.