Nitumie seva gani ya MCP?
Seva zote mbili zinatoa operesheni za PDF123. Zinatofautiana mahali zinapoendeshwa na jinsi faili zinavyozifikia.
| Ya ndani: @pdf123/mcp | Iliyohifadhiwa: /mcp | |
|---|---|---|
| Inaendeshwa wapi | Kwenye kompyuta yako, ikianzishwa na mteja wa MCP kupitia stdio | Kwenye seva za PDF123 kwenye https://pdf123.xyz/mcp |
| Ingizo | Njia za faili kwenye diski. Seva huzipakia na kuhifadhi matokeo kando ya ingizo | Faili zinazotumwa kupitia zana ya upakiaji |
| Vitambulisho | Hakuna kwa matumizi bila utambulisho. PDFX_API_KEY ni ya hiari | Kichwa cha X-API-KEY kwenye kila ombi. Bila hicho jibu ni 401 |
| Usakinishaji | npx -y @pdf123/mcp | Hakuna. Ongeza URL na kichwa kwenye mteja |
| Zana | Zana tano zinazofikia katalogi kamili ya zana 97 | Zana saba: describe, convert, pages, misc, security, upload na download |
| Itumie wakati | Wakala anafanya kazi kwenye hati za folda ya ndani | Wakala au huduma ya mbali tayari inashughulikia upakiaji kupitia API |
Tumia seva ya ndani kwa wasaidizi wa uandishi wa msimbo kwenye kompyuta ya mkononi. Tumia sehemu ya mwisho iliyohifadhiwa wakati wakala anaendeshwa kwenye wingu na hawezi kusoma diski yako.
Ninasakinishaje seva ya MCP ya ndani?
Hakuna cha kusakinisha, kwa sababu mteja wa MCP huanzisha seva kwa npx. Kwenye Claude Code, iongeze kwa amri moja.
claude mcp add pdf123 -- npx -y @pdf123/mcpClaude Desktop husoma claude_desktop_config.json, na Cursor husoma .cursor/mcp.json. Wateja wengine wana ukurasa au faili ya mipangilio ya MCP. Wote wanakubali kipengee kilekile cha mcpServers.
{
"mcpServers": {
"pdf123": {
"command": "npx",
"args": ["-y", "@pdf123/mcp"]
}
}
}Anzisha upya mteja baada ya kubadilisha usanidi wake. Ili kuweka nakala kwenye path yako, endesha npm install -g @pdf123/mcp, ambayo hutoa amri ya pdf123-mcp. Seva inahitaji Node 20.3 au mpya zaidi na msingi wa API unaofikika. Hakuna hali ya kutotumia mtandao.
Nimwombe wakala nini kwanza?
Omba kwa lugha ya kawaida na utaje faili. Kwa mfano:
Unganisha ~/Documents/a.pdf na ~/Documents/b.pdf, kisha ubane matokeo.
Wakala huita pdf123_run_pipeline, au pdf123_run_tool mara mbili, hupakia faili kwa PDF123, na kujibu kwa njia ya faili iliyohifadhiwa. Matokeo huhifadhiwa kando ya ingizo la kwanza na hayabadilishi faili iliyopo kamwe. Operesheni hizo hizo zipo kama Unganisha na Bana kwenye tovuti.
Seva ya ndani inatoa zana zipi?
Seva ina zana tano. Vitambulisho vya zana kama merge ni hoja za kawaida za maandishi, kwa hiyo orodha ya zana inabaki ndogo.
| Zana | Inafanya nini | Hoja kuu |
|---|---|---|
pdf123_list_tools | Inaorodhesha zana, mstari mmoja kwa kila moja | group, query, format |
pdf123_describe_tool | Inaonyesha sehemu za zana, thamani chaguomsingi, thamani zinazoruhusiwa na kama inaendeshwa kama kundi | tool |
pdf123_run_tool | Inaendesha zana moja kwenye faili za ndani na kurudisha njia iliyohifadhiwa au ripoti ya JSON | tool, files, params, output |
pdf123_run_pipeline | Inaunganisha hadi zana 8 kwenye ombi moja | steps, files, output |
pdf123_call | Inatuma ombi ghafi kwa kitambulisho chochote cha zana, kitambulisho cha operesheni au njia ya /api/... | target, files, fields |
Wakala kwa kawaida huita pdf123_list_tools kupata zana, pdf123_describe_tool kusoma sehemu zake, kisha pdf123_run_tool. Kitambulisho kilichoandikwa vibaya hurudisha mapendekezo ya "ulimaanisha".
Makundi, manenosiri na mnyororo wa zana hufanyaje kazi?
- Makundi. Faili kadhaa zinazopewa zana ya faili moja huendeshwa kama kundi lenye matokeo moja kwa kila faili. Kila faili huhifadhiwa inapokamilika. Jibu ni ripoti ya kila faili. Faili yoyote ikishindwa, jibu ni hitilafu yenye ripoti iliyoambatishwa, ili wakala aweze kujaribu tena faili zilizoshindwa pekee.
- Manenosiri.
input_passwordhufungua kila ingizo lililosimbwa.passwordshuweka nenosiri moja kwa kila faili, kwa mpangilio uleule wafiles, na mfuatano mtupu kwa faili isiyolindwa. Hii pia inafanya kazi kwa zana za faili nyingi kama Unganisha. - Mnyororo wa zana.
pdf123_run_pipelineinapokea hadi hatua 8, na kila hatua inalisha inayofuata. Inakubali hoja zilezile za nenosiri. - Maombi ghafi.
pdf123_callhufikia operesheni mpya kuliko seva. Hakuna kinachohakikiwa upande wa ndani. - Zana za kichujio. Zana ambayo kitambulisho chake kinaanza na
filter-hujibu{"matched": false}hali yake isipotimia. Hilo ni matokeo, si hitilafu. - Kujaribu tena.
idempotencyKeyhurudisha matokeo ya kwanza kwa saa 24.
Ninawekaje kikomo cha folda ambazo wakala anaweza kutumia?
Weka PDFX_MCP_ROOT iwe saraka. Tenganisha saraka kadhaa kwa nukta mbili, au nukta-mkato kwenye Windows. Seva kisha husoma ingizo na kuandika matokeo ndani ya saraka hizo pekee. Njia za nje yake, mianya ya .. na viungo vya ishara vinavyotoka nje hukataliwa kabla ya chochote kupakiwa, kwa Code: path_not_allowed. Bila kigeu hiki, njia yoyote ambayo mchakato wa seva unaweza kuifikia inaruhusiwa.
"env": { "PDFX_API_BASE": "https://pdf123.xyz", "PDFX_MCP_ROOT": "/Users/me/Documents/pdfs" }Weka vigeu vya mazingira kwenye kizuizi cha env cha mteja, au kwa claude mcp add -e NAME=value. PDFX_API_BASE huelekeza seva kwenye pdfx-server yako mwenyewe badala yake; tazama Self-host.
Matokeo na hitilafu zinaonekanaje?
Matokeo moja ni kitu kidogo cha JSON chenye path iliyohifadhiwa, contentType na ukubwa kwa bytes. Matokeo ya kundi yana processed, unmatched, failed na orodha ya files. Maumbo haya yanalingana na pdfx --json kwenye mstari wa amri. Zana inayorudisha ripoti, kama Maelezo ya hati, hurudisha ripoti moja kwa moja kwenye jibu.
{
"path": "/Users/me/Documents/merged.pdf",
"contentType": "application/pdf",
"bytes": 1096
}Simu iliyoshindwa hurudi kama hitilafu ya zana. Maandishi yake huishia kwa mistari ya Reason:, Code: na Hint: seva inapozitoa, ili wakala aweze kuamua kwa msimbo.
HTTP 400: This PDF is password-protected. Enter its password.
Reason: password_required
Code: bad_request
Hint: Provide the document password, or unlock the PDF first.Kitambulisho cha zana kikiwa na kosa la uandishi, hitilafu inaorodhesha vitambulisho vinavyokaribia na kuishia kwa Code: unknown_tool. Zana isiyopata cha kurudisha, kama pdf-to-csv kwenye PDF isiyo na majedwali, hurudisha Code: no_content badala ya faili tupu. Tazama Misimbo ya hitilafu.
Ninatumiaje sehemu ya mwisho ya MCP iliyohifadhiwa?
API ina seva ya MCP iliyojengewa ndani kwenye POST https://pdf123.xyz/mcp. Thibitisha kwa kichwa kilekile cha X-API-KEY ambacho REST API hutumia. Bila ufunguo sehemu hiyo ya mwisho hujibu 401. Unda ufunguo kwenye ukurasa wa Waendelezaji.
{
"mcpServers": {
"pdf123": {
"url": "https://pdf123.xyz/mcp",
"headers": { "X-API-KEY": "<your-key>" }
}
}
}Seva iliyohifadhiwa inaorodhesha zana saba: pdf_toolbox_describe_operation, pdf_toolbox_convert, pdf_toolbox_pages, pdf_toolbox_misc, pdf_toolbox_security, pdf_toolbox_upload na pdf_toolbox_download. Kila zana ya kategoria inapokea jina la operation na vigezo vyake, pamoja na faili au fileId iliyorudishwa na zana ya upakiaji. Tumia zana ya describe kupata skima ya operesheni moja.
Kurasa zinazohusiana
- Skill za mawakala kwa Claude Code, Codex na Cursor, moja kwa katalogi na moja kwa kila zana
- /llms.txt, faharasa ya maandishi wazi ya zana, API na sehemu ya mwisho ya MCP
- Mstari wa amri wa pdfx na TypeScript SDK, zinazoshiriki katalogi
- Muhtasari wa waendelezaji, hati ya OpenAPI na Swagger UI
- Kurasa za zana: Unganisha, Bana, OCR, Weka nenosiri, Rekebisha
- Machapisho "Built for AI Agents, Not Just Browsers" na "Same Operation, Four Clients" kwenye blogu ya PDF123
Maswali yanayoulizwa mara kwa mara
MCP ni nini?
MCP, Model Context Protocol, ni kiwango huria cha kuunganisha wateja wa AI na zana za nje. Mteja kama Claude Code huanzisha au kuwasiliana na seva ya MCP, huorodhesha zana zake, na kuziita kwa niaba ya mtumiaji.
Je, seva ya MCP ya ndani inafanya kazi bila mtandao?
Hapana. Inapakia faili kwa API ya PDF123, au kwa seva iliyotajwa kwenye PDFX_API_BASE, na kuhifadhi matokeo kwenye kompyuta yako. Msingi wa API lazima ufikiwe.
Je, inahitaji ufunguo wa API?
Seva ya ndani haihitaji ufunguo kwa matumizi bila utambulisho. Weka PDFX_API_KEY ikiwa seva yako inauhitaji. Sehemu ya mwisho iliyohifadhiwa kwenye /mcp daima inahitaji kichwa cha X-API-KEY.
Je, wakala anaweza kusoma faili yoyote kwenye kompyuta yangu?
Kwa chaguomsingi anaweza kusoma njia yoyote ambayo mchakato wa seva unaweza kuifikia. Weka PDFX_MCP_ROOT ili kupunguza usomaji na uandishi kwenye saraka unazochagua.
Faili zangu zinafanywa nini?
Seva ya ndani hupakia kila ingizo kwa API ya PDF123, au kwa seva yako mwenyewe, ili lichakatwe. Maelezo ya zana yanasema faili hufutwa huko baada ya kuchakatwa. Matokeo huhifadhiwa kwenye kompyuta yako. Kwa maelezo zaidi, soma ukurasa wa faragha ya faili.
Wakala anaweza kutumia zana ngapi?
Seva ya ndani hufikia zana zote 97 za katalogi kupitia zana tano za MCP. Sehemu ya mwisho iliyohifadhiwa hupanga operesheni zake kwa kategoria (convert, pages, misc na security) nyuma ya zana saba za MCP.