Samþætting
FTIR.fun MCP-þjónn & REST API
Tengdu FTIR.fun við AI-aðstoðarmanninn þinn eða sjálfvirknileyfi. MCP-þjónn fyrir Claude/Cursor/Codex. REST API fyrir sérsniðnar samþættingar. Sömu 130.000+ tilvísunarlitrófin og bókmenntastudd AI-túlkun í öllum aðferðum.
MCP-þjónn — Claude, Cursor, Codex
MCP-þjónn (Model Context Protocol) FTIR.fun hefur verið skoðaður og opinberlega skráður á Anthropic MCP Registry, Smithery og MCP.so. Hann afhjúpar FTIR litrófsleit, toppaútskýringar með DOI-tilvitnuðum heimildum og efnisgreiningu sem kallanleg tól fyrir hvaða MCP-samhæfðan viðskiptavin sem er.
Snögg tenging
# 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
Tól í boði
| Tól | Lýsing |
|---|---|
search_ftir_library | Leitaðu að 130K+ tilvísunarlitrófum eftir toppum eða innsendri skrá. Skilar flokkuðum samsvörunum með CAS-númerum og líkindastigum. |
search_public_ftir_results | Leitaðu að samfélagsdeildu greiningarniðurstöðum eftir leitarorði. |
fetch_public_ftir_result | Sæktu tiltekið opinbert FTIR greiningarniðurstöðu með auðkenni til nákvæmrar skoðunar. |
Þjónnaspjald & skrárhlekkir
- Server Card (JSON) — staðlaður MCP-þjónnauppgötvunarendapunktur
- Anthropic MCP Registry — opinberlega skráð
- Smithery — skoðað og gefið út
- MCP.so — skráð
- PyPI (ftirfun-mcp) — Python pakki
Coze viðbót — Notaðu inni í 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.
Leitarorð: 红外分析, FTIR, infrared, 光谱检索, 物质识别
REST API
Bókasafnsleit API
POST /v1/search
Litrófsbókasafnsleit. Tekur við skrá (full-litrófsjöfnun) eða hámarkslista (hámarksstöðujöfnun). Ef bæði eru veitt, hefur skráarleit forgang.
Auðkenning
X-API-Key: your-api-key
Beiðnishlutur
| Reitur | Tegund | Nauðsynlegt | Lýsing |
|---|---|---|---|
| file_base64 | string | eitt af | Base64-kóðuð tækjaskrá (styður CSV, SPA, OPUS, SPC, JCAMP-DX og 15+ önnur snið) |
| filename | string | með file_base64 | Upprunaleg skráarheiti með endingum (t.d. sample.spa) |
| peaks | number[] | eitt af | Listi yfir hámarksbylgjutölur í cm⁻¹ (t.d. [3026, 1601, 1493, 755]) |
| top_k | integer | nei (sjálfgefið 10) | Fjöldi niðurstaðna sem á að skila, hámark 50 |
| tolerance | integer | nei (sjálfgefið 8) | Hámarksjöfnunarþol í cm⁻¹, bil 1–30 |
Svar
{
"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
}
Dæmi — skráarupphleðsla
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())
Dæmi — topplisti
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())
Eingöngu gervigreindargreining fyrir núverandi niðurstöður
Notaðu þennan endapunkt aðeins eftir að leitarniðurstaða er þegar til. FTIR.fun les fyrst eða OCRar afhenta skýrslu, dregur út tilkynnta frambjóðendur og sýnishorn toppatöflu, keyrir síðan downstream KG og bókmenntabakaða greiningu.
POST /ftir/analyze_existing_results
Skýrslan verður að innihalda bæði tilkynnta leitarniðurstöðulistann og sýnishorn toppatöflu. Þessi endapunktur framkvæmir ekki litrófsbókasafnsleit sjálfur.
Auðkenning
X-API-Key: your-api-key
Beiðnishlutur
| Reitur | Tegund | Nauðsynlegt | Lýsing |
|---|---|---|---|
| report_text | string | eitt af | Hreinn texti afritaður úr núverandi tækja- eða bókasafnsskýrslu. Textinn verður að innihalda bæði tilkynntar niðurstöður og sýnishorn toppatöflu. |
| report_file_base64 | string | eitt af | Base64-kóðuð skýrsluskrá. Studd snið: PDF, DOC, DOCX, TXT, CSV, PNG, JPG, JPEG, WEBP, GIF, BMP, TIF, TIFF. |
| report_filename | string | með report_file_base64 | Upprunalegt skýrslu skráarnafn með viðbót (til dæmis report.pdf eða report.docx). |
| user_background_text | string | nei | Valfrjáls sýnisbakgrunnur. Þetta er einungis meðhöndlað sem mjúkt samhengi og ekki sem sönnunargagn. |
Ströng inntaksmörk
- Nauðsynlegur þáttur 1: að minnsta kosti einn tilkynntur leitarniðurstöðuframbjóðandi, eins og Top1 hit eða Top15 listi
- Nauðsynlegur þáttur 2: sýnishorn topplisti eða toppatafla í cm-1 úr sömu skýrslu
- Ef annar hvor þáttur vantar, skilar endapunkturinn HTTP 422 og myndar ekki greiningarskýrslu
Svar um árangur
{
"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": {}
}
Svar við vöntun inntaks
{
"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
}
}
}
Dæmi — Núverandi skýrslutexti
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())
Dæmi — Núverandi skýrsluskrá
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())
Villukóðar
| HTTP-staða | Merking |
|---|---|
| 200 | Árangur |
| 401 | Vantar eða ógildur API-lykill |
| 422 | Ógilt beiðnilíkami, óstutt skýrslusnið eða vantar nauðsynlega skýrsluþætti |
| 500 | Villa á þjóni |