MoleCare MCP Server

Model Context Protocol (MCP) 服务器，让 Claude 和其他 MCP 客户端可以访问：

1. 皮肤科知识 —— ABCDE 科普、SNOMED CT / ICD-10 辅助工具、风险因素提示

2. 可选的 MoleCare API 工具 —— 痣、趋势、分析（你的后端 + API 密钥）

3. 可选的 MLOps / 运维工具 —— 健康检查、MLflow、特征存储、基础设施（模拟优先）

不是医疗设备。 输出仅用于教育和操作辅助。请勿用于诊断或治疗决策。

产品网站：molecare.co.uk · 应用：iOS · Android

为什么会有这个项目

MoleCare 帮助人们长期追踪痣的变化，并为临床就诊做好准备。这个 MCP 服务器让开发者与运维人员可以：

• 从 Claude Desktop / Cursor 查询皮肤健康科普知识

• 基于 MoleCare 兼容 API 构建助手流程原型

• 在未设置凭证时，使用安全的模拟数据探索 MLOps 工具

Related MCP server: opentargets-mcp

快速开始

无需凭证、无需数据库、无需云账户。将以下内容添加到 MCP 客户端配置中并重启：

{
  "mcpServers": {
    "molecare": {
      "command": "npx",
      "args": ["-y", "molecare-mcp"]
    }
  }
}

在 macOS 上，Claude Desktop 的配置文件是 ~/Library/Application Support/Claude/claude_desktop_config.json。

皮肤科知识工具开箱即用——它们从随包附带的知识库中读取内容。任何会与后端通信的工具，在配置完成之前都会返回明确标注的模拟数据，因此你可以在决定是否启用任何后端功能之前，先完整探索全部工具。

完全不需要客户端也可以直接尝试：

npx -y molecare-mcp

它会启动并持续监听 stdio。如果没有任何输出，说明它正在正常运行。

连接真实后端

仅当你在运行与 MoleCare 兼容的 API 时才需要：

{
  "mcpServers": {
    "molecare": {
      "command": "npx",
      "args": ["-y", "molecare-mcp"],
      "env": {
        "MOLECARE_API_URL": "http://localhost:8080/api",
        "MOLECARE_API_KEY": "your-local-api-key"
      }
    }
  }
}

请使用 localhost（或你自己的部署地址）。不要把生产环境的密钥粘贴到会同步到云盘的配置文件里。

环境变量

除非你想启用真实后端，否则这些内容都是可选的。

参见 .env.example。

工具

皮肤科知识——无需任何配置

这些工具是大多数人安装本项目的理由。它们基于包内自带的知识库作答，不需要 API、不需要密钥、不需要网络。

资源： molecare://knowledge/* —— ABCDE 标准、Fitzpatrick 皮肤分型、预防、何时就医看皮肤科医生、SNOMED CT 与 ICD-10 参考。

MoleCare 产品数据——需要 API

在设置 MOLECARE_API_URL 之前，这些工具会返回清晰标注的模拟数据。

这些工具的存在是因为 MoleCare 通过一个 assistant 来运维这套技术栈。在大多数使用场景之外，它们的价值有限；而且除非配置了对应的后端，否则全部返回模拟数据。

AWS 工具需要 @aws-sdk/client-ec2 和 @aws-sdk/client-cloudwatch，它们是可选的 peer 依赖——默认不会被安装，因为它们会让不需要 AWS 功能、只想要皮肤科工具的用户白白多下载 33 MB。如果你需要真实 AWS 数据，请自行安装：

npm i @aws-sdk/client-ec2 @aws-sdk/client-cloudwatch

架构

Claude / Cursor / MCP client
        │ stdio (JSON-RPC)
        ▼
  molecare-mcp
   ├─ medical KB (local)
   ├─ MoleCare API client (optional)
   ├─ ontology / MLflow / Feast clients (optional)
   └─ AWS / CI clients (optional, mock if unset)
        │
        └─ optional HTTP GET /health  (Docker / ECS)

Docker

docker build -t molecare-mcp .
docker run --rm -p 3000:3000 molecare-mcp
curl http://localhost:3000/health

安全

• 切勿提交 .env 文件或 API 密钥——如需报告漏洞，请参阅 SECURITY.md。

• 演示和截图优先使用模拟模式。

• 接受 userId 的工具，只有在你将请求指向具备真实鉴权的真实后端时，才可能返回 PHI（受保护的健康信息）——请把这当作生产环境对待。

• 限流与鉴权应该在你的 API 上实现，而不只是交给 MCP 进程。

医疗免责声明

MoleCare MCP 提供的是教育性信息与开发者工具。它不诊断黑色素瘤或任何疾病。如果有健康问题，请务必咨询合格的临床医生。

开发

git clone https://github.com/MoleCare/molecare-mcp.git
cd molecare-mcp
npm install
npm run build
npm run dev      # auto-reload
npm run inspect  # browse tools in MCP Inspector

欢迎贡献！请先阅读 CONTRIBUTING.md，其中包含模拟优先原则、所有涉及医疗内容的功能必须遵守的临床安全边界，以及如何领取 good first issue 任务。

请勿在示例中包含敏感信息，并建议优先使用 localhost。

相关链接

环境变量： .env.example 是权威清单（包含源代码读取的全部 27 个变量）。如需重新生成基准清单，请使用 grep -rhoE "process\.env\.[A-Z_0-9]+" src/。ONTOLOGY_API_URL 和 FEAST_REPO_PATH 不会被任何源文件读取。

• Model Context Protocol

• MoleCare

• MoleCare-ML ——黑色素瘤分类服务与训练 Notebook

许可证

Apache-2.0 © MoleCare LTD