Construirea unui MCPB - Pachetare server MCP local

Ce face

Skill-ul build-mcpb împachetează un server MCP local împreună cu runtime-ul său (Node sau Python) într-un singur fișier .mcpb. Utilizatorul instalează doar acel fișier și serverul rulează fără să aibă nevoie de Node, Python sau alte tool-uri pe mașina lui. MCPB este varianta oficială pentru distribuția serverelor care trebuie să ruleze local, accesând fișiere, aplicații desktop sau API-uri de sistem.

Când îmi folosește

Activezi skill-ul când utilizatorul spune „package an MCP server”, „make an MCPB”, „ship a local MCP server”, menționează fișiere .mcpb sau vrea să bundle-eze runtime-ul cu serverul. Se folosește doar pentru servere care rulează pe mașina utilizatorului (filesystem local, desktop apps, localhost). Pentru servere remote care apelează doar API-uri cloud, folosești build-mcp-server.

Cum îl invoc / declanșez

Skill-ul se declanșează automat când cererea utilizatorului se potrivește cu descrierea din SKILL.md. Verifică doctrina pentru detalii exacte despre invocare.

Exemplu practic

Utilizatorul vrea un server care citește fișiere din ~/Documents și rulează fără Node instalat. Tu creezi manifest.json cu server.type: node, entry_point și mcp_config care folosește ${__dirname} și ${user_config.rootDir}. Apoi skill-ul generează arhiva .mcpb cu manifest.json, folderul server/ și dependințele.

Output / unde aterizează

Rezultatul este un fișier .mcpb (arhivă zip) ce conține manifest.json, codul serverului și runtime-ul. Gazda (Claude Desktop) citește manifestul, lansează comanda din mcp_config ca stdio MCP server și substituie variabilele la instalare. Fișierul este gata de distribuție.

Limite / gotchas

MCPB este calea secundară — Anthropic recomandă servere remote pentru majoritatea cazurilor. Nu există auto-prefix la paths, deci trebuie să folosești ${__dirname} explicit. Serverul trebuie să fie stdio; alte tipuri de transport nu sunt suportate. Compatibilitatea se declară în compatibility (platforme și versiune Claude Desktop). Verifică schema manifestului înainte de generare. All guides