Rhowch fynediad uniongyrchol i'ch cynorthwyydd AI neu'ch cod eich hun at 130,000+ o sbectra cyfeirio, rhesymu copaon graff gwybodaeth, a dehongliad wedi'i gefnogi gan lenyddiaeth. Dewiswch un o dair ffordd i gysylltu — MCP ar gyfer cynorthwywyr AI, REST API ar gyfer cod, neu Sgil barod ar gyfer llwyfannau dim cod. Mae pob llwybr isod yn cynnwys cyfarwyddiadau cam-wrth-gam wedi'u hysgrifennu ar gyfer defnyddwyr tro cyntaf.
Mae MCP a'r REST API yn defnyddio un allwedd API FTIR.fun. Mae Coze/Doubao yn defnyddio allwedd gwasanaeth a ffurfweddwyd gan gyhoeddwr y plugin, felly nid yw defnyddwyr terfynol yn gludo allwedd bersonol. Mae cael allwedd bersonol yn cymryd tua munud:
Mewngofnodi i FTIR.funCrëwch gyfrif am ddim os nad oes gennych un. Mae cyfrifon newydd yn cynnwys credydau treial am ddim.
Copïwch ac arbedwch yr allwedd ar unwaithMae'r allwedd lawn (yn dechrau gyda ftir_) yn cael ei dangos unwaith yn unig. Storiwch mewn lle diogel. Os byddwch yn ei cholli, cynhyrchwch un newydd.
⚠️Mae'r gweinydd MCP a gynhelir yn derbyn allwedd API cyfrif yn unig a gynhyrchir yn y Bwrdd Gwaith Allweddi API FTIR.fun (yn dechrau gyda ftir_). Mae allweddi meistr ochr gweinydd ar gyfer gweithredwyr REST ac ni allant fewngofnodi i MCP a gynhelir.
Cam 1 — Pa gysylltiad sy'n iawn i chi?
Mae'r tri yn cysylltu â'r un injan: 130,000+ sbectra, rhesymeg graff gwybodaeth, a dyfyniadau llenyddiaeth. Dim ond un sydd ei angen arnoch. Dewiswch yn ôl sut rydych yn gweithio — ddim yn siŵr? MCP yw'r dewis mwyaf poblogaidd i unrhyw un sy'n defnyddio cynorthwyydd AI.
MCPLlwybr A — Gweinydd MCP
Mae MCP (Protocol Cyd-destun Model) yn ffordd safonol i gynorthwywyr AI alw offer allanol. Mae FTIR.fun yn rhedeg gweinydd MCP â chynhaliaeth — nid ydych yn gosod nac yn rhedeg dim yn lleol. Rydych yn ychwanegu un cyfluniad bach i'ch cleient AI, yn rhoi eich allwedd API, ac mae eich cynorthwyydd yn cael saith offeryn FTIR.
✓Sut mae mewngofnodi'n gweithio (darllenwch hwn yn gyntaf):
Mae FTIR.fun yn dilysu gyda'r allwedd API o'ch cyfrif, a anfonir fel pennawd Awdurdodi: Bearer. Nid oes mewngofnodi porwr OAuth na thudalen awdurdodi ar wahân. Os bydd cleient byth yn ceisio agor tudalen we awdurdodi, mae'n defnyddio ffurfweddiad hen ffasiwn — gweler Datrys Problemau isod.
Dewiswch eich cleient ar gyfer camau manwl:
VS
Gosod MCP FTIR.fun yn VS Code
Angen VS Code cyfredol gyda GitHub Copilot Chat yn y modd Asiant.
Agorwch eich prosiect, yna creu'r ffeil .vscode/mcp.jsonO fewn eich ffolder prosiect, gwnewch ffolder o'r enw .vscode (os nad yw'n bodoli) a ffeil o'r enw mcp.json y tu mewn iddo. Eisiau FTIR.fun ar gael ym mhob prosiect? Rhowch yr un JSON yn eich gosodiadau lefel defnyddiwr: agorwch y Palet Gorchymyn, chwiliwch 'Preferences: Open User Settings (JSON)', ac ychwanegwch gofnod mcp.servers yno yn lle.
Gludo'r union ffurfweddiad hwnCopïwch fel y mae. Peidiwch â disodli'r rhan ${input:...} gyda'ch allwedd go iawn — bydd VS Code yn gofyn am yr allwedd yn ddiogel pan fydd y gweinydd yn cychwyn.
Dechrau'r gweinydd ftirfunAgorwch y Palet Gorchmynion, rhedeg “MCP: Rhestru Gweinyddion”, dewiswch ftirfun, a dewiswch Dechrau. Mae rhai fersiynau VS Code yn dangos gweithred Dechrau uwchben y gweinydd yn mcp.json — mae hynny'n gweithio hefyd.
Gludwch eich allwedd API yn unig pan ofynnirPan fydd VS Code yn gofyn am ftirfun-api-key, gludwch yr allwedd amrwd yn unig (yn dechrau gyda ftir_). Peidiwch â theipio'r gair Bearer — mae'r cyfluniad yn ei ychwanegu'n awtomatig.
Cadarnhewch ei fod wedi cysylltuAgorwch Copilot Chat yn y modd Asiant a gwiriwch y rhestr offer. Dylai FTIR.fun ddangos saith offer. Yna rhowch gynnig ar yr awgrym prawf isod.
Use FTIR.fun to explain the FTIR peak at 1715 cm-1.
💬Gwelsoch dudalen awdurdodi neu wall “nid yw'r dudalen awdurdodi yn bodoli” o'r blaen? Roedd hwnnw'n ffurfwedd OAuth-arddull hen ffasiwn. Dilewch yr hen gofnod ftirfun, gludwch y JSON uchod, ail-lwythwch VS Code, a dechreuwch eto. Trwsiad llawn yn Troubleshooting.
A
Gosodwch FTIR.fun MCP yn Claude
Wedi'i restru'n swyddogol ar Gofrestr MCP Anthropic. Yn gweithio yn Claude Desktop a Claude Code.
Agorwch osodiadau gweinydd MCPYn Claude Desktop, ewch i Gosodiadau → Cysylltwyr → Ychwanegu cysylltydd arferiad. Yn Claude Code, golygwch eich ffeil cyfluniad MCP.
Ychwanegwch y gweinydd o bell a phennyn BearerDefnyddiwch y URL a gynhelir ac ychwanegwch eich allwedd API fel pennawd Awdurdodi. Amnewidiwch y lle deiliad gyda'ch gwir allwedd (yn dechrau gyda ftir_).
Ailgychwyn Claude a chadarnhauAilgychwynnwch Claude Desktop, agorwch y panel cysylltwyr/offer, a chadarnhewch fod offer FTIR.fun yn ymddangos. Yna gofynnwch gwestiwn mewn iaith plaen.
Identify this polymer from its FTIR peaks: 2915, 1715, 1450 cm-1.
📎Ydych chi'n ffafrio Claude Code CLI? Rhedeg claude mcp add --transport http ftirfun https://ftir.fun/mcp --header "Authorization: Bearer ftir_your_key_here".
Cu
Gosodwch FTIR.fun MCP yn Cursor
Golygwch ffurfwedd MCP Cursor fel y gall eich golygydd cod AI alw FTIR.fun heb adael y IDE.
Agorwch y ffeil ffurfweddu MCPCreu neu olygu ~/.cursor/mcp.json (byd-eang) neu .cursor/mcp.json o fewn eich prosiect.
Gludo bloc y gweinyddAmnewidiwch y placeholder gyda'ch allwedd go iawn (yn dechrau gyda ftir_).
Ail-lwytho Cursor a chadarnhauAilagorwch Cursor, gwiriwch Gosodiadau → MCP am y gweinydd ftirfun a'i statws gwyrdd, yna gofynnwch yn y sgwrs.
Cx
Sefydlwch FTIR.fun MCP yn Codex neu unrhyw harnais MCP
Yn gweithio gydag OpenAI Codex ac unrhyw gleient sy'n gydnaws â MCP sy'n cefnogi gweinyddwyr HTTP o bell.
Ychwanegwch y gweinydd i'ch cyfluniad CodexTynnwch sylw'r cleient at y URL a gynhelir a sicrhewch ei fod yn anfon eich allwedd API fel pennawd Bearer. Amnewidiwch y manneilluwr â'ch allwedd go iawn.
Ailgychwyn Gemini CLI a chadarnhauRhedeg /mcp i restru gweinyddion a chadarnhau bod ftirfun wedi'i gysylltu cyn anog.
🧩Yn defnyddio cleient MCP arall? Mae unrhyw gleient sy'n cefnogi gweinydd HTTP ffrydio o bell yn gweithio: gosodwch y URL i https://ftir.fun/mcp ac anfon Authorization: Bearer <your key>. Gweler cerdyn y gweinydd cyhoeddus am gynllun yr offeryn llawn: server-card.json
✓Ar ôl cysylltiad llwyddiannus, dylai eich cleient AI restru'r 7 offeryn hyn:parse_ftir_spectrum, analyze_ftir_spectrum, submit_ftir_report, get_ftir_report_status, explain_peaks, find_spectra, fetch_result.
Os gwelwch lai o offer neu ddim o gwbl, gwiriwch yr Adran Datrys Problemau isod.
APILlwybr B — REST API
Galwch FTIR.fun o'ch cod eich hun mewn unrhyw iaith — Python, JavaScript, R, MATLAB, Java, Go. Endpoints HTTP safonol ar gyfer adnabod sbectra anhysbys, egluro copaon, dod o hyd i sbectra cyfeirio, a nôl canlyniad blaenorol yn ôl rhif adroddiad. Delfrydol ar gyfer integreiddiadau LIMS, piblinellau swp, neu ychwanegu chwiliad FTIR i'ch ap eich hun.
Gwiriwch fod y gwasanaeth REST ar-leinMae'r pwynt terfyn iechyd yn gyhoeddus ac nid yw'n defnyddio pwyntiau. Dylai ddychwelyd y JSON isod. Os gwelwch dudalen HTML neu amseru allan, efallai bod y gwasanaeth i lawr dros dro.
curl
curl https://ftir.fun/health
Ymateb disgwyliedig
{"status":"ok","service":"ftirfun-api"}
Dilyswch gyda'r pennawd X-API-KeyMae pob pwynt terfyn gwarchodedig yn cymryd eich allwedd mewn pennyn X-API-Key. Mae'r un rheolau cyfrif yn berthnasol ag yn yr ap gwe: pwyntiau, tanysgrifiad, a chyfyngiadau cyfradd. Os yw'r allwedd yn anghywir neu ar goll, fe gewch wall JSON 401.
Pennawd awdurdodi
X-API-Key: ftir_your_key_here
Gwnewch eich galwad gyntaf — adnabod sbectrwm anhysbysAnfonwch restr brig (neu ffeil wedi'i huwchlwytho) a chael deunyddiau ymgeisydd wedi'u graddio gyda sgoriau tebygrwydd a thystiolaeth brig. Mae'r bloc opsiynau yn ddewisol — y rhagosodiadau yw top_k=15 (ystod 1–50) a tolerance_cm1=8 (ystod 1–30).
{
"success": true,
"search_mode": "peak_only",
"n_matches": 5,
"confidence": 0.42,
"confidence_source": "peak_match_score",
"summary": "Peak-based FTIR matching ranks Styrene/acrylonitrile copolymer first...",
"matches": [
{"rank": 1, "name": "Styrene/acrylonitrile copolymer", "cas": "9003-54-7",
"num": 119319, "score": 0.4214, "matched": 6}
],
"evidence": ["3026 cm-1 -> alkyl C-H vibration (DOI 10.5650/jos.ess14201)"],
"peak_explanations": [
{"peak_cm1": 3026, "assignment": "alkyl C-H vibration",
"evidence_type": "kg_peak_group"}
],
"uncertainty": "The leading match is close to the runner-up..."
}
Archwiliwch weddill y pwyntiau terfynMae'r cyfeiriad llawn yn cwmpasu pob pwynt terfyn, fformatau cais ac ymateb, codau gwall, a mwy o samplau cod. Gweler y Dogfennaeth API.
Beth rydych chi ei eisiau
Endpoint
Mewnbwn
Adnabod sbectrwm anhysbys
POST /ftir/analyze_spectrum
Corff JSON gyda spectrum.peaks neu file_base64
Egluro un neu fwy o gopaon
POST /ftir/explain_peak_assignments
Corff JSON gyda rhestr brig neu destun ymholiad
Dod o hyd i sbectrwm cyfeirnod hysbys
POST /ftir/find_spectra
Corff JSON gyda llinyn ymholiad
Nôl canlyniad blaenorol yn ôl rhif adroddiad
GET /ftir/result/{result_num}
Parametr llwybr, dewisol ?language_code=en
Cyflwynwch adroddiad async llawn, yna pleidleisiwch arno
POST /ftir/reports · GET /ftir/reports/{task_id}
Corff JSON gyda file_base64 (gofynnol)
Dadansoddi ffeil offeryn i gopaon
POST /parse-spectrum
Uwchlwytho ffeil amlran NEU JSON gyda file_base64
Cyfeirnod paramedr allweddol
Parametr
Math
Rhagosodedig
Ystod
Defnyddir gan
top_k
int
15
1–50
analyze_spectrum
tolerance_cm1
int
8
1–30
analyze_spectrum
limit
int
10
1–20
find_spectra
sampling_mode
string
(gwag)
Gweler y rhestr isod
reports, explain_peaks
language_code
string
"en"
ISO 639-1
reports, fetch_result
include_report
bool
true
—
get_ftir_report_status
📘Yn adeiladu GPT personol neu'n mewnforio i offeryn arall? Mewnforiwch ein cynllun OpenAPI yn uniongyrchol: openapi.platform.yaml.
Dadansoddi ffeil offeryn (dwy ffordd)
Mae'r pwynt terfyn /parse-spectrum yn derbyn naill ai uwchlwytho ffeil amlran neu gorff JSON gyda chynnwys wedi'i amgodio base64. Mae'r ddau yn dychwelyd yr un ymateb: brigau a ganfuwyd a'r gromlin lawn.
Ar gyfer llwyfannau AI ac awtomeiddio poblogaidd, rydym yn cludo pecynnau parod, felly nid oes rhaid i chi ysgrifennu galwadau API â llaw. Gosodwch becyn neu fewnforiwch plug-in, a daw FTIR.fun yn floc adeiladu yn eich llif gwaith. Mae pob cerdyn isod yn dweud wrthych yn union beth i'w redeg neu fewnforio.
LC
LangChain
Pecyn Python · PyPI
Cyhoeddwyd
Offerynnau parod i'w gosod ar gyfer adeiladu asiantau sy'n ymwybodol o FTIR. Yn trin codio Base64, ailgeisiadau, a galwadau anghydamserol i chi.
Gosod
pip install langchain-ftirfun
Galwad leiaf
from langchain_ftirfun import explain_peaks
result = explain_peaks(
api_base_url="https://ftir.fun",
api_key="ftir_your_key_here",
peaks=[1715],
)
print(result)
Mewnforiwch FTIRFUN_TOOLS i gael yr holl saith swyddogaeth mewn rhestr. Mae pob swyddogaeth yn cymryd api_base_url a api_key fel y ddau ddadl gyntaf.
Mae'r ategyn cwmwl Coze yn cael ei gyhoeddi gyda thri offeryn: dadansoddi sbectrwm, chwilio llyfrgell gyfeirio, ac esboniad brig. Gall defnyddwyr terfynol ei ddefnyddio'n uniongyrchol yn Doubao heb ffurfweddu unrhyw allwedd API.
Mae cwota'n cael ei olrhain fesul defnyddiwr trwy sys_uuid Coze. Mae'r ategyn yn defnyddio allwedd gwasanaeth a ffurfweddwyd gan y cyhoeddwr.
GPT
ChatGPT
GPT Custom · Gweithredoedd GPT
Mae'r schema yn barod
Adeiladu GPT personol sy'n dadansoddi sbectra, yn egluro copaon, ac yn dod o hyd i sbectra cyfeirio. Mewnforiwch ein cynllun OpenAPI fel Gweithred. Angen ChatGPT Plus.
Mewnforio URL
https://ftir.fun/openapi.platform.yaml
Yn y golygydd GPT: Ffurfweddu → Gweithredoedd → Mewnforio o URL. Gosodwch auth i API Key (pennawd X-API-Key).
Mae'r dosbarthiadau MCP, REST, n8n, a LangChain cyfredol yn datgelu saith gweithrediad. Mae'r ategyn Coze a gyhoeddwyd yn datgelu tair offeryn (dadansoddi, dod o hyd i, esbonio), ac efallai y bydd templedi eraill yn datgelu set ddatganedig llai; gwiriwch bob cerdyn platfform cyn ei ddefnyddio. Mae'r gweithrediadau isod yn rhannu'r un gwasanaethau FTIR.fun.
Tasg
Teclyn MCP
Pwynt terfyn REST
Dywedwch hyn wrth eich AI
Darllen ffeil offeryn
parse_ftir_spectrum
POST /parse-spectrum
Dadansoddi sample.spc a rhestru'r copaon a ganfuwyd.
Adnabod sbectrwm anhysbys
analyze_ftir_spectrum
POST /ftir/analyze_spectrum
Nodi pa bolymer yw'r sbectrwm hwn.
Cyflwynwch adroddiad tri-echel llawn
submit_ftir_report
POST /ftir/reports
Cyflwynwch sample.spa am adroddiad llawn yn y modd ATR.
Pleidleisiwch ac adferwch yr adroddiad hwnnw
get_ftir_report_status
GET /ftir/reports/{task_id}
Gwiriwch y dasg adroddiad a rhowch y ddolen i mi pan fydd wedi'i gwblhau.
Esbonio copaon
explain_peaks
POST /ftir/explain_peak_assignments
Beth mae'r copaon ar 1715 a 1450 cm-1 yn ei ddangos?
Dod o hyd i sbectrwm cyfeirnod hysbys
find_spectra
POST /ftir/find_spectra
Canfod sbectra cyfeirio ar gyfer polystyren.
Ailagor canlyniad cynharach
fetch_result
GET /ftir/result/{result_num}
Nôl canlyniad 20260528100755416137536.
Ffeiliau a gefnogir: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON. Gwerthoedd sampling_mode dilys yw Peled KBr, Anwedd, Toddydd, Ffilm Denau, Mull Paraffin, ATR, Adlewyrchiad Gwasgaredig, Micro IR, ac Eraill. Nid yw Trosglwyddiad yn werth dilys. Cadwch yr estyniad ffeil gwreiddiol fel bod FTIR.fun yn dewis y parser cywir.
{
"success": true,
"search_mode": "peak_explanation",
"peak_explanations": [
{"peaks_cm1": [1715, 1450],
"assignment": "1715 cm-1 suggests C=O stretching (ester or carboxylic acid)...",
"evidence_type": "llm_general_knowledge"}
],
"summary": "Peak explanation based on general FTIR knowledge..."
}
Cael yr adroddiad llawn (anghydamserol)
Mae sgrinio cyflym (analyze_spectrum) yn dychwelyd ar unwaith. Mae'r adroddiad tri-echel llawn yn rhedeg yn y cefndir ac fel arfer yn cymryd 30–90 eiliad. Peidiwch ag ailddanysod tra bod adroddiad yn rhedeg — cadwch y task_id a phleidleisiwch.
CyflwynoGalwch submit_ftir_report (MCP) neu POST /ftir/reports (REST). Byddwch yn cael task_id a result_num wrth gefn. Mae'r maes file_base64 yn ofynnol; mae meysydd eraill (sampling_mode, prior_context, language_code, sample_name, sample_order_no) yn ddewisol.
PôlGalwch get_ftir_report_status (MCP) neu GET /ftir/reports/{task_id} bob 5–10 eiliad nes bod completed yn true. Mae'r ymateb wedi'i gwblhau yn cynnwys report_url, report_view (cynnwys adroddiad strwythuredig), a result_num.
Agorwch yr adroddiad terfynolAgorwch yr URL llawn https://ftir.fun/outputdata/?num={result_num} mewn porwr i weld tudalen ganlyniad tri-echel gyflawn a rendrir gan FTIR.fun.
⚠️Peidiwch â chyflwyno'r un adroddiad eto tra ei fod mewn ciw neu'n rhedeg. Cadwch y task_id a pharhau i bleidleisio nes iddo gwblhau neu fethu. Mae cyflwyniadau dyblyg yn gwastraffu pwyntiau.
Datrys Problemau
Yr hyn a welwch
Beth mae'n ei olygu
Beth i'w wneud
Mae'r cleient yn agor tudalen awdurdodi porwr, neu'n dweud nad yw'r dudalen awdurdodi yn bodoli.
Mae eich cleient yn defnyddio cofnod gweinydd hen-ffasiwn OAuth. Nid yw FTIR.fun yn defnyddio OAuth — dim ond allwedd API.
Dilewch yr hen gofnod gweinydd ftirfun, gludwch y ffurfwedd union o'r dudalen hon, ail-lwythwch y cleient, a dechreuwch ftirfun eto.
401 (MCP) / 401 invalid_api_key (REST)
Mae'r allwedd API ar goll, wedi dod i ben, wedi'i dirymu, neu wedi'i gludo'n anghywir.
Ailgychwynnwch y gweinydd a gludwch yr allwedd crai yn unig (yn dechrau gyda ftir_). Cynhyrchwch allwedd newydd o'r Dangosfwrdd Allweddi API os oes angen.
Mae'r gweinydd yn dechrau ond nid oes offer yn ymddangos.
Nid yw'r cleient wedi adnewyddu ei gatalog, neu mae'r ffurfwedd yn defnyddio enw allwedd anghywir.
Ar gyfer VS Code, cadarnhewch fod mcp.json yn defnyddio gweinyddion (nid mcpServers). Yna stopiwch a dechreuwch ftirfun, neu ail-lwythwch y ffenestr.
403 insufficient_balance
Nid oes gan y cyfrif ddigon o bwyntiau ar gyfer y dadansoddiad hwnnw.
Gwiriwch eich balans neu danysgrifiad yn FTIR.fun, yna rhowch gynnig arall arni.
429 rate_limit_exceeded
Mae dadansoddi a pharsio REST yn caniatáu 60 o geisiadau y funud fesul allwedd API; mae darlleniadau canlyniad REST a statws-adrodd yn defnyddio bwced ar wahân o 120 cais y funud; mae MCP yn caniatáu 60 galwad y funud ar gyfer pob allwedd API ac offeryn.
Arhoswch am y cyfnod aildrio a adroddir gan yr offeryn cyn galw eto.
Mae adroddiad yn aros mewn ciw neu'n rhedeg.
Mae adroddiadau llawn yn rhedeg yn anghydamserol ac yn cymryd mwy o amser na sgrinio cyflym.
Cadwch yr un task_id a pharhewch i boli. Peidiwch â chreu adroddiadau dyblyg.
422 neu missing_input
Mae'r corff cais yn colli meysydd gofynnol neu mae ganddo fformat annilys. Ar gyfer analyze_spectrum, rhaid i chi ddarparu o leiaf un o'r canlynol: peaks, query, neu file_base64.
Gwiriwch fod eich JSON yn ddilys, Content-Type yn application/json, a bod meysydd gofynnol yn bresennol. Gweler yr enghreifftiau o geisiadau uchod.
413 file_too_large
Mae'r ffeil sbectrwm a uwchlwythwyd yn fwy na'r terfyn maint.
Allforiwch ffeil llai neu defnyddiwch safleoedd brig yn unig trwy'r maes spectrum.peaks.
Yn barod i adeiladu?
Mae'r cyfeirnod REST llawn yn cynnwys pob endpoint, fformatau cais ac ymateb, dilysu, terfynau cyfradd, codau gwall, diffiniadau offer MCP, ac enghreifftiau cod yn Python a curl.
Gall sefydliadau a wahoddwyd i'r rhaglen dreial 7 diwrnod roi eu cod gwahoddiad isod i dderbyn cyfrif a chyfrinair. Cadwch eich manylion mewngofnodi yn ddiogel ar ôl actifadu.
Ar gyfer Sefydliadau GwahoddedigNodwch y cod a ddarperir gan eich sefydliad neu ein tîm allgymorth.
Cael Cyfrif a GyfrinairAr ôl actifadu, byddwch yn derbyn enw defnyddiwr a chyfrinair — cadwch nhw ar unwaith.
7 Diwrnod Mynediad LlawnMwynhewch fynediad di-rwystr i'r holl nodweddion am 7 diwrnod o'r actifadu.
Cyfrif wedi'i greu!
Enw Defnyddiwr
Cyfrinair
Daw i ben
Ar gyfer defnyddwyr eraill
Mewngofnodwch a rhannwch eich dolen wahoddiad gyda chydweithwyr, cyd-ddisgyblion, a ffrindiau. Mae pob cofrestriad llwyddiannus yn rhoi defnydd treial ychwanegol i chi.