Nenda kwenye maudhui makuu
PPDF123

Seva za MCP za PDF123 kwa mawakala wa AI

MCP, Model Context Protocol, ni kiwango huria kinachoruhusu wateja wa AI kama Claude Code, Claude Desktop na Cursor kuita zana za nje. PDF123 inatoa seva ya MCP ya ndani, @pdf123/mcp, kwa faili zilizo kwenye kompyuta yako, na sehemu ya mwisho iliyohifadhiwa kwenye seva zetu inayotumia ufunguo wa API.

@pdf123/mcpNode 20.3 au mpya zaidi

Sakinisha

npx -y @pdf123/mcp
Kwenye ukurasa huu

Nitumie seva gani ya MCP?

Seva zote mbili zinatoa operesheni za PDF123. Zinatofautiana mahali zinapoendeshwa na jinsi faili zinavyozifikia.

Ya ndani: @pdf123/mcpIliyohifadhiwa: /mcp
Inaendeshwa wapiKwenye kompyuta yako, ikianzishwa na mteja wa MCP kupitia stdioKwenye seva za PDF123 kwenye https://pdf123.xyz/mcp
IngizoNjia za faili kwenye diski. Seva huzipakia na kuhifadhi matokeo kando ya ingizoFaili zinazotumwa kupitia zana ya upakiaji
VitambulishoHakuna kwa matumizi bila utambulisho. PDFX_API_KEY ni ya hiariKichwa cha X-API-KEY kwenye kila ombi. Bila hicho jibu ni 401
Usakinishajinpx -y @pdf123/mcpHakuna. Ongeza URL na kichwa kwenye mteja
ZanaZana tano zinazofikia katalogi kamili ya zana 97Zana saba: describe, convert, pages, misc, security, upload na download
Itumie wakatiWakala anafanya kazi kwenye hati za folda ya ndaniWakala 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 Codebash
claude mcp add pdf123 -- npx -y @pdf123/mcp

Claude 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.

Usanidi wa mteja wa MCPjson
{
  "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.

ZanaInafanya niniHoja kuu
pdf123_list_toolsInaorodhesha zana, mstari mmoja kwa kila mojagroup, query, format
pdf123_describe_toolInaonyesha sehemu za zana, thamani chaguomsingi, thamani zinazoruhusiwa na kama inaendeshwa kama kunditool
pdf123_run_toolInaendesha zana moja kwenye faili za ndani na kurudisha njia iliyohifadhiwa au ripoti ya JSONtool, files, params, output
pdf123_run_pipelineInaunganisha hadi zana 8 kwenye ombi mojasteps, files, output
pdf123_callInatuma 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_password hufungua kila ingizo lililosimbwa. passwords huweka nenosiri moja kwa kila faili, kwa mpangilio uleule wa files, na mfuatano mtupu kwa faili isiyolindwa. Hii pia inafanya kazi kwa zana za faili nyingi kama Unganisha.
  • Mnyororo wa zana. pdf123_run_pipeline inapokea hadi hatua 8, na kila hatua inalisha inayofuata. Inakubali hoja zilezile za nenosiri.
  • Maombi ghafi. pdf123_call hufikia 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. idempotencyKey hurudisha 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.

Zuia ufikiaji wa failijson
"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.

Matokeo mojajson
{
  "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.

Maandishi ya hitilafutext
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.

Usanidi wa sehemu ya mwisho iliyohifadhiwajson
{
  "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.

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.