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 权限。

环境变量

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

工具列表

系统提示词

项目附带了推荐的系统提示词 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。