概览
ChemDataDoctor MCP 是独立的 TypeScript MCP Server,通过 stdio 向 AI 助手提供本地化学表格检查能力,与 ChemDataDoctor Web 是不同的产品入口。源码包与服务器元数据标注版本 0.1.0;核验时仓库没有 GitHub Release 或 tag。官方提供源码安装方式,尚未核实 npm 注册表发布状态。
支持 CSV、TSV、XLS、XLSX、JSON 文件及小型内联二维数组。JSON 可为行数组集合或扁平对象数组,不接受嵌套对象或数组。必须指定 CAS 列,名称与分子式列可选。清洗会另存 JSON 报告和 CSV/XLSX 副本,保留源文件及重复行。
服务器不需要账号或 API Key,运行时不依赖托管服务。安装时需下载依赖,其中 SheetJS 来自官方 CDN;源码没有出站请求或遥测。MCP 客户端决定哪些输入与输出会发给模型服务商,因此服务器本地运行不等于 AI 助手全程离线。数据集调用默认只返回计数,可选样本仅含元数据,本地产物仍含用户数据。
CAS 检查仅验证格式与校验位,不确认注册状态或物质身份。名称整理仅处理空白和不可见字符,不进行同义词归并或系统命名。分子式检查使用有限语法,不验证化学合理性或 CAS、名称、分子式之间的对应关系;电荷、显式同位素和聚合物记法无法验证。重复检测不会合并物质身份或删除行,也不在调用之间共享去重状态。
文件上限为 20 MiB、50,000 条数据行、200 列、所有工作表合计 2,000,000 个单元格和 100 个工作表;内联输入最多 201 行,包含可选表头。程序将受限输入读入内存。数据根目录限制属于应用层路径保护,并非操作系统沙箱。项目自身代码采用 MIT 许可证,第三方依赖保留各自许可证。
主要功能
- validate_cas:CAS 格式与校验位检查,可选保守格式修正。
- normalize_names:整理空白与不可见字符,保留大小写和化学记法。
- validate_formulas:检查有限分子式语法并统计原子。
- detect_duplicates:返回重复 CAS 或文本的位置,保留记录。
- clean_dataset:另存本地清洗副本与报告;quality_report:只检查,不写文件。
使用场景
- 导入前检查化学品库存表格。
- 通过 MCP 客户端检查化合物表格质量。
- 保留原值并生成可追溯的本地清洗副本。
使用方式
需要 Node.js 22.12+ 和 npm。将示例数据路径替换为已经存在的专用目录;在 MCP 客户端中配置 node、dist/cli.js 的绝对路径及 --data-root,进程通过 stdio 等待请求。
git clone https://github.com/chemaiatlas/chemdatadoctor-mcp.git
cd chemdatadoctor-mcp
npm ci --ignore-scripts
npm run build
node dist/cli.js --data-root /absolute/path/to/data
先使用该输入调用 quality_report;需要另存清洗副本时再调用 clean_dataset,并以 applyFixes=true 启用保守修正。默认输出目录为数据根目录内的 .chemdatadoctor-output。
{"path":"inventory.xlsx","sheetIndex":0,"columns":{"cas":0,"name":1,"formula":2}}
GitHub · ChemDataDoctor Web · README · MIT
来源与核查边界
本条目说明所链接项目来源中记载的能力。条目编辑更新不代表完成过运行测试、兼容性测试或科学性能评估。
查看编辑与核查政策