Ftir Spectral Search

中国語 | 英語 | スペイン語 | フランス語 | 日本語

FTIR.fun MCP サーバー

FTIR.fun 用の MCP サーバーおよび REST API クライアントです。AI アシスタントやコードパイプラインから、130,000 件以上の FTIR 赤外線参照スペクトルに直接アクセスし、物質の識別、ピークの説明、スペクトルライブラリの検索を行えます。

利用可能なツールの概要

ツール	機能
analyze_ftir_spectrum	未知の FTIR スペクトルを識別します。ピーク、自然言語によるクエリ、または装置ファイル（28 種類以上の形式）を指定できます。類似度スコアと文献 DOI 付きで、候補をランキング形式で返します。
explain_peaks	1 つ以上の赤外線ピーク位置を説明します。ライブラリ全体を検索せずに官能基を割り当てます。
parse_ftir_spectrum	FTIR 装置の生ファイルを解析し、波数と強度のデータポイント、および検出されたピークを取得します。
find_spectra	物質名、CAS 番号、またはキーワードで 130,000 件以上の参照ライブラリを検索します。比較用の曲線データを返します。
submit_ftir_report	スペクトルを、完全な 3 軸識別ワークフロー（ウェブサイトと同じ多段階解析）に送信します。
get_ftir_report_status	レポートの進行状況を確認します。完了すると、構造化された完全な結果と共有可能な URL を返します。
fetch_result	レポート番号を指定して、FTIR.fun の過去の解析結果を取得します。

---

API キーの取得

1. ftir.fun にサインインします。新規アカウントには無料トライアルのクレジットが含まれます。
2. アカウント → API キー に移動し、生成 をクリックします。
3. キーをすぐにコピーします（ftir_ で始まり、一度しか表示されません）。

認証には単一のヘッダーを使用します。OAuth もブラウザーへのリダイレクトも不要です。

# For MCP (hosted)
Authorization: Bearer ftir_your_key_here

# For REST API
X-API-Key: ftir_your_key_here

---

MCP ツール

ホスト型 MCP エンドポイント https://ftir.fun/mcp は、7 つのツールを公開しています。

---

analyze_ftir_spectrum

未知のスペクトル 1 件について、FTIR 赤外線スペクトルライブラリを検索します。ピーク、自然言語によるクエリ、または装置の生ファイルを指定できます。

パラメーター

パラメーター	型	必須	説明
query	string	いいえ	自然言語による FTIR リクエストです。「1730, 1600, 1250 cm-1」のようなピーク位置は自動的に抽出されます。
peaks	number[]	いいえ	FTIR のピーク位置（cm⁻¹）（例：[1736, 1379, 1241]）。
file_base64	string	いいえ	FTIR 装置ファイルを Base64 でエンコードしたものです。Thermo .spa/.spc、Bruker .opus、PerkinElmer .sp、JCAMP-DX .jdx/.dx、CSV、Excel など、28 種類以上の形式に対応しています。
filename	string	いいえ	形式の検出に使用する元のファイル名です（例："sample.spa"）。
top_k	integer	いいえ	返す候補のランキング数（1～50、デフォルトは 15）。
tolerance_cm1	integer	いいえ	ピーク照合の許容範囲（cm⁻¹）（1～30、デフォルトは 8）。

戻り値： ライブラリとの類似度スコア、公開文献（DOI）に関連付けられたピークごとの根拠、信頼度、および不確実性に関する開示情報を含む、候補物質のランキング。

例

Identify this infrared spectrum: peaks at 2915, 1715, 1450, 1260, 1090 cm-1.

---

explain_peaks

FTIR の赤外線ピークを 1 つ以上、スペクトルライブラリ全体を検索せずに解説します。官能基の迅速な割り当てや波数の解釈に役立ちます。

パラメーター

パラメーター	型	必須	説明
query	string	いいえ	ピークに関する自然言語での質問。例："What does 1715 cm-1 indicate in an ester?"
peaks	number[]	いいえ	1 つ以上の FTIR ピーク位置（cm⁻¹）。
sampling_mode	string	いいえ	ATR、Thin Film、KBr Pellet、Nujol Mull など。

戻り値： 官能基の割り当てと、利用可能な場合は不確実性を示す表現を含む、構造化されたピークの解説です。

例

Use FTIR.fun to explain the infrared peaks at 1715 and 3300 cm-1 in ATR mode.

---

parse_ftir_spectrum

Base64 でエンコードされた FTIR 装置ファイルを、波数と強度が対応した曲線データ点、および自動検出されたピーク位置に解析します。解析前に生のスペクトルデータを抽出する際に使用します。

パラメーター

パラメーター	型	必須	説明
file_base64	string	はい	Base64 でエンコードされた FTIR 装置ファイル。
filename	string	はい	形式検出用の元のファイル名（例："sample.spa"）。

戻り値： 対応する (wavenumber, intensity) データ点と、検出されたピーク位置（cm⁻¹）のリストです。

---

find_spectra

物質名、CAS 番号、スペクトル番号、またはキーワードで FTIR ライブラリの参照スペクトルを検索します。直接比較できる生のスペクトル曲線データを返します。

パラメーター

パラメーター	型	必須	説明
query	string	はい	物質名（例："polypropylene"）、CAS 番号、FTIR ライブラリの NUM、またはキーワード。
limit	integer	いいえ	返す参照スペクトルの数（1～20、デフォルトは 10）。

戻り値： num、名称、CAS、ピークマーカー、およびライブラリの曲線データを含む、一致した参照スペクトルです。

例

Find FTIR reference spectra for polyethylene terephthalate (PET).

---

submit_ftir_report

Base64 でエンコードされた FTIR スペクトルファイルを、FTIR.fun の完全な三軸識別ワークフローに送信します。これはウェブサイトで使用されているものと同じ多段階解析です。すぐに task_id と result_num が返されます。解析レポートの完成後に取得するには、get_ftir_report_status で状態を確認してください。

パラメーター

パラメーター	型	必須	説明
file_base64	string	はい	Base64 でエンコードされた FTIR 装置ファイル。
filename	string	はい	形式検出用の元のファイル名。

戻り値： { task_id, result_num }

---

get_ftir_report_status

submit_ftir_report で送信したレポートの状態を確認します。完了すると、応答には構造化された完全な report_view（FTIR.fun のウェブサイトに表示されるものと同じデータ）と、共有可能な report_url が含まれます。

パラメーター

パラメーター	型	必須	説明
task_id	string	はい	submit_ftir_report が返す task_id。

戻り値： 状態フィールド。完了時は report_view と report_url も含まれます。

---

fetch_result

レポート番号を指定して、過去の FTIR.fun 赤外線解析結果を取得します。

パラメーター

パラメーター	型	必須	説明
result_num	string	はい	FTIR.fun のレポート／結果番号。
language_code	string	いいえ	保存された結果のコンテキストに表示する言語（デフォルトは en）。

戻り値： report_url、headline、summary、report_view、および result_context を含む構造化されたコンテキストです。

---

REST API

Python、JavaScript、R、MATLAB、Go など、任意の言語から FTIR.fun を直接呼び出せます。LIMS との連携、一括スペクトル処理パイプライン、または独自アプリケーションへの赤外線スペクトル検索の追加に最適です。

API の完全なリファレンス：https://ftir.fun/api-docs/

ヘルスチェック（キー不要）

curl https://ftir.fun/health
# → {"status":"ok","service":"ftirfun-api"}

未知の赤外線スペクトルを識別する — ピークリスト

curl -X POST https://ftir.fun/ftir/analyze_spectrum \
  -H "X-API-Key: ftir_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "peaks": [2915, 1715, 1450, 1260, 1090],
    "options": {"top_k": 10, "tolerance_cm1": 8}
  }'

import requests

resp = requests.post(
    "https://ftir.fun/ftir/analyze_spectrum",
    headers={"X-API-Key": "ftir_your_key_here"},
    json={
        "peaks": [2915, 1715, 1450, 1260, 1090],
        "options": {"top_k": 10, "tolerance_cm1": 8},
    },
)
print(resp.json())

装置ファイルから特定

import base64, requests

with open("sample.spa", "rb") as f:
    b64 = base64.b64encode(f.read()).decode()

resp = requests.post(
    "https://ftir.fun/ftir/analyze_spectrum",
    headers={"X-API-Key": "ftir_your_key_here"},
    json={"file_base64": b64, "filename": "sample.spa"},
)
print(resp.json())

28種類以上の装置ファイル形式に対応しています：Thermo .spa／.spc、Bruker .opus、PerkinElmer .sp、JCAMP-DX .jdx／.dx、CSV、Excel など。

赤外線ピークを解説

curl -X POST https://ftir.fun/ftir/explain_peaks \
  -H "X-API-Key: ftir_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"peaks": [1715, 2915], "sampling_mode": "ATR"}'

名前またはCASで参照スペクトルを検索

curl "https://ftir.fun/v1/search?q=polypropylene&limit=5" \
  -H "X-API-Key: ftir_your_key_here"

---

MCP クライアントのセットアップ

ホスト型MCPエンドポイントはローカルへのインストールが不要です。Bearerトークンを使用してhttps://ftir.fun/mcpに接続してください。

VS Code（GitHub Copilot エージェントモード）

プロジェクト内に.vscode/mcp.jsonを作成するか、ユーザーレベルの設定に追加してください。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "ftirfun-api-key",
      "description": "FTIR.fun API key",
      "password": true
    }
  ],
  "servers": {
    "ftirfun": {
      "type": "http",
      "url": "https://ftir.fun/mcp",
      "headers": {
        "Authorization": "Bearer ${input:ftirfun-api-key}"
      }
    }
  }
}

コマンドパレットを開き、MCP: List Servers → ftirfunを選択 → Startを選択します。

Claude Desktop / Claude Code

URL:    https://ftir.fun/mcp
Header: Authorization: Bearer ftir_your_key_here

Claude Codeのワンラインセットアップ：

claude mcp add --transport http ftirfun https://ftir.fun/mcp \
  --header "Authorization: Bearer ftir_your_key_here"

Cursor

~/.cursor/mcp.jsonを作成または編集します：

{
  "mcpServers": {
    "ftirfun": {
      "url": "https://ftir.fun/mcp",
      "headers": {
        "Authorization": "Bearer ftir_your_key_here"
      }
    }
  }
}

OpenAI Codex

[mcp_servers.ftirfun]
url = "https://ftir.fun/mcp"
http_headers = { Authorization = "Bearer ftir_your_key_here" }

Gemini CLI

~/.gemini/settings.jsonを編集します：

{
  "mcpServers": {
    "ftirfun": {
      "httpUrl": "https://ftir.fun/mcp",
      "headers": {
        "Authorization": "Bearer ftir_your_key_here"
      }
    }
  }
}

リモートのストリーム可能なHTTPサーバーに対応している他のMCPクライアントも利用できます。URLにhttps://ftir.fun/mcpを設定し、Authorization: Bearer <your key>を送信してください。ツールスキーマの全容：server-card.json。

---

セルフホスト（ローカルラッパー）

ホスト型APIへのプロキシとして機能する、軽量なローカルMCPラッパーです。同じ7つのFTIRツールを公開します。

設定

export FTIRFUN_API_KEY="your-ftirfun-api-key"
# Optional:
export FTIRFUN_API_BASE_URL="https://ftir.fun"
export FTIRFUN_API_TIMEOUT_SECONDS="120"

ローカルで実行（stdio）

python -m venv .venv
. .venv/bin/activate
pip install .
ftirfun-mcp

ストリーム可能なHTTPで実行

FTIRFUN_API_KEY="your-ftirfun-api-key" \
ftirfun-mcp --transport streamable-http --host 127.0.0.1 --port 8001

Docker

docker build -t ftirfun-mcp .
docker run --rm -p 8001:8001 -e FTIRFUN_API_KEY="your-ftirfun-api-key" ftirfun-mcp

---

ツールの適用範囲

このMCPサーバーはFTIRスペクトルライブラリのスクリーニング専用です。FTIR以外の分光法、一般的な化学に関するQ&A、認定試験機関による認証には使用しないでください。

---

FTIR.funについて

FTIR.funは、52か国以上の研究者やエンジニアが利用する、赤外分光分析用のクラウドプラットフォームです。ポリマー、添加剤、コーティング剤、医薬品、工業用化学物質を網羅する、継続的に更新される13万件以上のFTIR参照スペクトルにすばやくアクセスできます。

ftir.funでできること：

• スペクトルライブラリ検索 — 装置ファイルをアップロードするかピーク位置を貼り付けると、類似度スコアと文献のDOI引用付きで候補を順位付けして表示します
• AIピーク解説 — 任意の波数について質問すると、化学ナレッジグラフに基づく官能基の帰属が得られます
• 3軸分析レポート — 複数段階の自動材料特定を行い、共有可能な結果URLを生成します
• 画像からCSVへの抽出 — 公開論文の図からスペクトル曲線をデジタル化します
• 配合ワークベンチ — 複数成分の配合分解と未知混合物の分析を行います

ステップごとのセットアップガイド：https://ftir.fun/ai-integration/

---

レジストリとリンク

リソース	URL
ウェブサイト	https://ftir.fun
セットアップガイド	https://ftir.fun/ai-integration/
APIドキュメント	https://ftir.fun/api-docs/
ホスト型MCPエンドポイント	https://ftir.fun/mcp
サーバーカード	https://ftir.fun/.well-known/mcp/server-card.json
Smithery	https://smithery.ai/servers/hlin2097/ftirfun
MCP.so	https://mcp.so/server/ftir-spectral-search/ftir_fun
PyPI	https://pypi.org/project/ftirfun-mcp/