KnowS MCP Server

KnowS 医学证据检索与分析平台的 MCP (Model Context Protocol) Server。

安装与使用

前置条件

本包发布在 GitHub Packages，需要先配置 npm registry。在 ~/.npmrc 中添加：

//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN
@PancrePal-xiaoyibao:registry=https://npm.pkg.github.com

YOUR_GITHUB_TOKEN 需要有 read:packages 权限。

环境变量

变量	必填	说明
KNOWS_API_KEY	是	KnowS API 密钥
KNOWS_API_HOST	否	API 地址，默认 https://dev-api.nullht.com

Claude Code 配置

在 ~/.claude/settings.json 或项目 .claude/settings.json 中添加：

{
  "mcpServers": {
    "knows": {
      "command": "npx",
      "args": ["@PancrePal-xiaoyibao/knows-mcp-server"],
      "env": {
        "KNOWS_API_KEY": "your_api_key",
        "KNOWS_API_HOST": "https://api.nullht.com"
      }
    }
  }
}

Claude Desktop 配置

在 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）中添加：

{
  "mcpServers": {
    "knows": {
      "command": "npx",
      "args": ["@PancrePal-xiaoyibao/knows-mcp-server"],
      "env": {
        "KNOWS_API_KEY": "your_api_key",
        "KNOWS_API_HOST": "https://api.nullht.com"
      }
    }
  }
}

直接运行

# 通过 npx
KNOWS_API_KEY=your_key npx @PancrePal-xiaoyibao/knows-mcp-server

# 或全局安装后运行
npm install -g @PancrePal-xiaoyibao/knows-mcp-server
KNOWS_API_KEY=your_key knows-mcp-server

本地开发

# 安装依赖
npm install

# 使用 bun 开发（热重载）
KNOWS_API_KEY=your_key bun run dev

# 构建
npm run build

# 运行构建产物
KNOWS_API_KEY=your_key npm start

工具列表

工具	说明
ai_search	AI 检索，根据问题返回相关医学证据列表
evidence_summary	单篇证据 AI 概要总结
all_evidence_summary	获取所有证据的 AI 总结
evidence_highlight	获取证据被引用的原文内容
answer	基于问题和证据生成场景总结
answer_stream	场景总结（流式收集）
auto_tagging	证据自动化标签提取
get_paper_en	英文文献详情
get_paper_cn	中文文献详情
get_guide	指南详情
get_meeting	会议详情
list_questions	历史提问列表
list_interpretations	文献解读历史列表
create_evidence_by_pdf	通过 PDF 创建新证据

系统提示词

项目附带了推荐的系统提示词 SYSTEM_PROMPT.md，用于指导 AI 助手基于 KnowS 工具进行结构化的医学文献调研。

发版

# 更新 package.json 中的 version 后
git tag v0.x.x
git push origin v0.x.x

推送 v* tag 后，GitHub Actions 会自动运行测试并发布到 GitHub Packages。