概要
ChemDataDoctor MCP は、化学データ表の点検機能を MCP の stdio 接続で提供する、TypeScript 製の独立したサーバーです。ChemDataDoctor の Web アプリとは別の製品として利用します。ソースのパッケージとサーバー情報はバージョン 0.1.0 を示しています。確認時点では GitHub Release とタグはなく、ソースからの導入手順が案内されています。npm レジストリでの公開状況は未確認です。
CSV、TSV、XLS、XLSX、JSON ファイルと、小規模な行配列を受け付けます。JSON は行配列の配列またはフラットなオブジェクトの配列に対応し、入れ子の値は扱いません。CAS 列の指定は必須で、名称列と分子式列は任意です。処理結果は JSON レポートと CSV/XLSX の別ファイルに保存され、元ファイルと重複行は保持されます。
サーバーの利用にアカウントや API キーは不要で、実行時に外部のホスト型サービスを必要としません。導入時には依存パッケージを取得し、SheetJS は公式 CDN からダウンロードします。ソースには外向きの通信やテレメトリーはありません。ただし、モデル提供元に送信する入出力は MCP クライアントが管理します。サーバーがローカルで動いても、アシスタント全体がオフラインになるとは限りません。データセット処理は通常、件数だけを返し、任意のサンプルにもメタデータのみを含めます。ローカルの出力ファイルには利用者のデータが含まれます。
CAS 番号の検証範囲は形式とチェックサムであり、登録の有無や物質の同一性は確認しません。名称の整形は空白と不可視文字に限定され、同義語の統合や体系名への変換は行いません。分子式は限定された文法で点検し、化学的妥当性や CAS・名称との対応は保証しません。電荷、明示的な同位体、ポリマー表記は検証対象外です。重複を検出しても行は削除されず、呼び出し間で重複検出の状態は共有されません。
ファイルの上限は 20 MiB、データ 50,000 行、200 列、全シート合計 2,000,000 セル、100 シートです。直接渡す配列は任意の見出し行を含め最大 201 行です。入力は上限付きでメモリに読み込みます。データルートの制限はアプリケーションによるパス保護であり、OS のサンドボックスではありません。プロジェクト本体は 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
出典と確認の範囲
この掲載情報はリンク先のプロジェクト資料に記載された機能を説明します。掲載情報の更新は、実行、互換性試験、科学的性能評価の実施を意味しません。
編集・確認方針を読む