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。