Integreiddio
Gweinydd MCP FTIR.fun ac API REST
Cysylltwch FTIR.fun â＇ch cynorthwyydd AI neu biblinell awtomeiddio. Gweinydd MCP ar gyfer Claude/Cursor/Codex. API REST ar gyfer integreiddiadau personol. Yr un 130,000+ o sbectra cyfeirio a dehongliad AI wedi＇i gefnogi gan lenyddiaeth ar draws pob dull.
Gweinydd MCP — Claude, Cursor, Codex
Mae gweinydd MCP (Protocol Cyd-destun Model) FTIR.fun wedi＇i adolygu a＇i restru＇n swyddogol ar Gofrestr MCP Anthropic, Smithery, a MCP.so. Mae＇n datgelu chwilio sbectrol FTIR, esboniad copaon gyda llenyddiaeth a ddyfynnir gan DOI, ac adnabyddiaeth deunydd fel offer y gellir eu galw ar gyfer unrhyw gleient sy＇n gydnaws â MCP.
Cysylltu Cyflym
# Claude Desktop / Claude Code
claude mcp add ftirfun https://ftir.fun/mcp
# Cursor
# Add to ~/.cursor/mcp.json:
{"mcpServers": {"ftirfun": {"url": "https://ftir.fun/mcp"}}}
# OpenAI Codex
codex mcp add ftirfun https://ftir.fun/mcp
Offer Sydd ar Gael
| Offeryn | Disgrifiad |
|---|---|
search_ftir_library | Chwiliwch dros 130K o sbectra cyfeirio yn ôl copaon neu ffeil a lwythwyd i fyny. Yn dychwelyd cyfatebiaethau wedi＇u graddio gyda rhifau CAS a sgoriau tebygrwydd. |
search_public_ftir_results | Chwiliwch ganlyniadau dadansoddi a rennir gan y gymuned yn ôl allweddair. |
fetch_public_ftir_result | Cyrchwch ganlyniad dadansoddiad FTIR cyhoeddus penodol yn ôl ID ar gyfer adolygiad manwl. |
Cerdyn Gweinydd a Dolenni Cofrestr
- Server Card (JSON) — pwynt darganfod gweinydd MCP safonol
- Anthropic MCP Registry — wedi＇i restru＇n swyddogol
- Smithery — adolygwyd a chyhoeddwyd
- MCP.so — wedi＇i restru
- PyPI (ftirfun-mcp) — Pecyn Python
Plugin Coze — Defnyddiwch y Tu Mewn i Doubao
Open Doubao → Plugin Store → search "FTIR" or "红外分析" → tap Add. No configuration needed. Doubao will automatically route infrared-related queries to our spectral search engine.
Geiriau chwilio: 红外分析, FTIR, is-goch, 光谱检索, 物质识别
API REST
API Chwilio Llyfrgell
POST /v1/search
Chwiliad llyfrgell sbectrol. Derbynnir ffeil (paru sbectrwm llawn) neu restr brig (paru safle brig). Os darperir y ddau, mae chwiliad ffeil yn cael blaenoriaeth.
Dilysu
X-API-Key: your-api-key
Corff Cais
| Maes | Math | Angenrheidiol | Disgrifiad |
|---|---|---|---|
| file_base64 | string | un o | Ffeil offer wedi＇i hamgodio Base64 (yn cefnogi CSV, SPA, OPUS, SPC, JCAMP-DX, a 15+ fformat arall) |
| filename | string | gyda file_base64 | Enw ffeil gwreiddiol gan gynnwys estyniad (e.e. sample.spa) |
| peaks | number[] | un o | Rhestr o rifau tonnau brig mewn cm⁻¹ (e.e. [3026, 1601, 1493, 755]) |
| top_k | integer | na (diofyn 10) | Nifer y canlyniadau i＇w dychwelyd, mwyafswm 50 |
| tolerance | integer | na (diofyn 8) | Goddefiant paru brig mewn cm⁻¹, ystod 1–30 |
Ymateb
{
"success": true,
"search_mode": "full_spectrum",
"n_matches": 10,
"matches": [
{
"rank": 1,
"name": "Polystyrene",
"cas": "25086-18-4",
"num": 326,
"similarity": 0.9586
}
],
"file_format": "Thermo SPA",
"n_points": 3601,
"error": null
}
Enghraifft — Llwytho Ffeil
import base64, requests
with open("sample.spa", "rb") as f:
b64 = base64.b64encode(f.read()).decode()
resp = requests.post(
"https://api.ftir.fun/v1/search",
headers={"X-API-Key": "your-key", "Content-Type": "application/json"},
json={"file_base64": b64, "filename": "sample.spa", "top_k": 5},
)
print(resp.json())
Enghraifft — Rhestr Brig
import requests
resp = requests.post(
"https://api.ftir.fun/v1/search",
headers={"X-API-Key": "your-key", "Content-Type": "application/json"},
json={"peaks": [3082, 3026, 2923, 1601, 1493, 1451, 1028, 906, 755, 699], "top_k": 5},
)
print(resp.json())
Dadansoddiad AI-yn-Unig ar gyfer Canlyniadau Presennol
Defnyddiwch y pwynt terfyn hwn dim ond ar ôl bod canlyniad chwilio eisoes yn bodoli. Mae FTIR.fun yn darllen neu＇n OCR yr adroddiad a ddarparwyd yn gyntaf, yn echdynnu＇r ymgeiswyr a adroddwyd a thabl brig y sampl, yna＇n rhedeg dadansoddiad i lawr yr afon KG a gefnogir gan lenyddiaeth.
POST /ftir/analyze_existing_results
Rhaid i＇r adroddiad gynnwys y rhestr canlyniadau chwilio a adroddwyd a thabl brig y sampl. Nid yw＇r pwynt terfyn hwn yn cynnal chwiliad llyfrgell sbectrol ar ei ben ei hun.
Dilysu
X-API-Key: your-api-key
Corff Cais
| Maes | Math | Angenrheidiol | Disgrifiad |
|---|---|---|---|
| report_text | string | un o | Testun plaen a gopïwyd o adroddiad offeryn neu lyfrgell sy＇n bodoli. Rhaid i＇r testun gynnwys y canlyniadau a adroddwyd a thabl brig y sampl. |
| report_file_base64 | string | un o | Ffeil adroddiad wedi＇i hamgodio â Base64. Fformatau a gefnogir: PDF, DOC, DOCX, TXT, CSV, PNG, JPG, JPEG, WEBP, GIF, BMP, TIF, TIFF. |
| report_filename | string | gyda report_file_base64 | Enw ffeil adroddiad gwreiddiol yn cynnwys estyniad (er enghraifft report.pdf neu report.docx). |
| user_background_text | string | na | Cefndir sampl dewisol. Mae hyn yn cael ei drin fel cyd-destun meddal yn unig ac nid fel tystiolaeth. |
Ffin Mewnbwn Caled
- Elfen gofynnol 1: o leiaf un ymgeisydd canlyniad chwilio a adroddwyd, megis canlyniad Top1 neu restr Top15
- Elfen gofynnol 2: y rhestr brig sampl neu dabl brig mewn cm-1 o＇r un adroddiad
- Os yw＇r naill elfen neu＇r llall ar goll, mae＇r pwynt terfyn yn dychwelyd HTTP 422 ac nid yw＇n cynhyrchu adroddiad dadansoddi
Ymateb Llwyddiant
{
"success": true,
"analysis_mode": "ai_only_existing_results",
"message": "AI-only analysis completed from the supplied existing results report.",
"input_requirements": {
"service_boundary": "AI-only analysis starts after a search result already exists.",
"required_inputs": [
"At least one reported search result candidate (Top1 or Top15).",
"The sample peak table or peak list in cm-1."
]
},
"missing_requirements": [],
"missing_requirement_messages": [],
"extracted_report": {
"source_kind": "pdf",
"used_ocr": true,
"peak_values_cm1": [1736, 1601, 1241],
"library_candidates": [
{"rank": 1, "name": "Polyethylene terephthalate", "cas_number": "25038-59-9", "raw_score_text": "856/1000", "normalized_similarity": 0.856}
]
},
"summary": "Reported library results rank Polyethylene terephthalate first.",
"report_view": {},
"final_decision": {},
"direct_evidence": {},
"related_literature": {}
}
Ymateb Mewnbwn ar Goll
{
"detail": {
"success": false,
"analysis_mode": "ai_only_existing_results",
"error": "missing_required_report_elements",
"message": "AI-only analysis requires both reported library results and a sample peak table.",
"missing_requirements": ["sample_peak_table"],
"missing_requirement_messages": [
"Missing sample peak table. Provide the sample peak list or peak table in cm-1 from the same report."
],
"input_requirements": {
"failure_behavior": "If either the reported result list or the sample peak table is missing, the service stops and returns a 422 response."
},
"extracted_report": {
"report_has_library_results": true,
"report_has_peak_table": false
}
}
}
Enghraifft — Testun Adroddiad Presennol
import requests
report_text = """
Sample: PET fragment
Top1: Polyethylene terephthalate Score: 856/1000
Top2: Polyester resin Score: 801/1000
Peak table (cm-1): 3435, 2932, 1715, 1409, 1241, 1093, 1017, 872, 722
"""
resp = requests.post(
"https://api.ftir.fun/ftir/analyze_existing_results",
headers={"X-API-Key": "your-key", "Content-Type": "application/json"},
json={"report_text": report_text, "user_background_text": "consumer packaging fragment"},
)
print(resp.json())
Enghraifft — Ffeil Adroddiad Presennol
import base64, requests
with open("instrument-report.pdf", "rb") as f:
b64 = base64.b64encode(f.read()).decode()
resp = requests.post(
"https://api.ftir.fun/ftir/analyze_existing_results",
headers={"X-API-Key": "your-key", "Content-Type": "application/json"},
json={
"report_file_base64": b64,
"report_filename": "instrument-report.pdf",
"user_background_text": "suspected packaging adhesive",
},
)
print(resp.json())
Codau Gwall
| Statws HTTP | Ystyr |
|---|---|
| 200 | Llwyddiant |
| 401 | Allwedd API ar goll neu annilys |
| 422 | Corff cais annilys, fformat adroddiad heb ei gefnogi, neu elfennau adroddiad gofynnol ar goll |
| 500 | Gwall ochr gweinydd |