awesome-medical-mcp-server: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Monorepo Architecture Overview

这是一个医疗 MCP (Model Context Protocol) 服务器的 monorepo，每个 src/ 下的目录都是独立的 TypeScript/Node.js 包，可以独立开发、构建、测试和发布到 npm registry。

核心特征

• 独立包管理: 每个医疗工具都是独立的 npm 包
• 统一脚手架: 所有包遵循相同的结构和标准
• 批量操作: 支持批量构建、测试、发布
• 无依赖关系: 包之间完全独立，无交叉依赖

开发命令

Monorepo 管理

# 安装所有依赖并构建
npm run bootstrap

# 构建所有包
npm run build

# 运行所有包的测试
npm run test

# 代码质量检查
npm run lint
npm run format

# 清理所有构建文件
npm run clean

# 列出所有工作空间包
npm run list-packages

包管理操作

# 创建新的医疗工具包
npm run create-package <包名> <显示名称> <功能描述>
# 示例：
npm run create-package egfr-calculator "EGFR计算器" "肾小球滤过率计算"

# 版本管理
npm run version:bump patch   # 所有包升级补丁版本
npm run version:bump minor   # 所有包升级次版本
npm run version:bump major   # 所有包升级主版本

# 发布管理
npm run publish:all          # 发布所有包到 npm
npm run publish:all --dry-run # 预览发布（不实际发布）

# DXT 扩展打包
npm run pack:dxt             # 为所有包打包DXT扩展（输出到 release/ 目录）
npm run pack:dxt:all         # 批量打包所有DXT扩展（统一输出到 release/ 目录）

# 更新 TypeScript 项目引用
npm run update-tsconfig

单个包开发

cd src/<package-name>

npm run dev          # 开发模式（自动重载）
npm run build        # 构建当前包
npm run test         # 测试当前包
npm run lint         # 检查当前包代码质量
npm start           # 运行构建后的包
npm run pack:dxt     # 打包为DXT扩展（输出到根目录 release/ 目录）

包结构标准

每个医疗工具包遵循以下标准结构：

src/<package-name>/
├── package.json          # 包配置 (@medical-mcp/<name>)
├── manifest.json         # DXT扩展清单文件 (必需)
├── tsconfig.json         # TypeScript 配置
├── src/
│   ├── index.ts          # MCP 服务器主文件
│   └── types.ts          # TypeScript 类型定义
├── scripts/
│   └── pack-dxt.js       # DXT打包脚本
├── README.md             # 包说明文档
├── examples.md           # 使用示例
└── dist/                 # 构建输出目录
    └── *.js              # 编译后的JS文件

包命名规范

• npm 包名: @medical-mcp/<name> (例如: @medical-mcp/egfr-calculator)
• 目录名: kebab-case 格式 (例如: egfr-calculator)
• 显示名: 中文医疗术语 (例如: "EGFR计算器")