Integrasi AI
Meshy mendedahkan dua saluran untuk ejen AI dan pembantu pengekodan: MCP server Meshy untuk pemanggilan alat, dan llms.txt / llms-full.txt untuk pengambilan dokumentasi.
Jika anda mengintegrasikan Meshy dari Claude Code, Cursor, Windsurf, Codex, atau mana-mana alat lain yang serasi dengan MCP, pasang MCP server di bawah. Jika anda mengintegrasikan daripada ejen sembang biasa tanpa sokongan MCP, arahkannya ke https://docs.meshy.ai/llms.txt sebagai gantinya.
Apakah itu MCP
Model Context Protocol (MCP) ialah standard terbuka yang membolehkan pembantu AI memanggil alat luaran dan mendapatkan konteks berstruktur. MCP server Meshy membalut Meshy API REST sebagai satu set alat yang boleh dipanggil oleh ejen anda — menjana model, menyemak tugas, memuat turun hasil — tanpa perlu menulis kod HTTP secara manual.
MCP server adalah sumber terbuka dan diterbitkan di npm sebagai @meshy-ai/meshy-mcp-server. Sumber: github.com/meshy-dev/meshy-mcp-server.
Anda memerlukan kunci API Meshy. Cipta satu di laman API Keys dalam Developer Platform. MCP server membacanya daripada pembolehubah persekitaran MESHY_API_KEY.
Pemasangan Pantas
# Detects installed AI clients and configures Meshy for each
npx add-mcp @meshy-ai/meshy-mcp-server --env MESHY_API_KEY=msy_YOUR_API_KEY
Lebih suka kemahiran siap pakai? Pek kemahiran sumber terbuka meshy-3d-agent menyediakan aliran kerja Meshy yang telah ditulis terlebih dahulu (jana → tinjau → muat turun) untuk Claude Code, Cursor, dan OpenClaw. Ia memanggil Meshy API REST secara langsung — tiada MCP server diperlukan.
npx skills add meshy-dev/meshy-3d-agent
Alatan Tersedia
MCP server mendedahkan Meshy API REST sebagai alat, dikumpulkan mengikut keupayaan.
Penjanaan 3D
meshy_text_to_3d: cipta jejaring pratonton tanpa tekstur daripada prompt teksmeshy_image_to_3d: cipta model 3D daripada satu imejmeshy_multi_image_to_3d: cipta model 3D daripada pelbagai imej objek yang samameshy_text_to_3d_refine: tambah tekstur pada jejaring pratonton
Pascapemprosesan
meshy_remesh: ubah topology dan/atau bilangan poligon model sedia adameshy_retexture: guna pakai tekstur baharu pada model sedia adameshy_rig: tambah rangka pada watak humanoid 3Dmeshy_animate: guna pakai animasi pada watak yang telah di-rigmeshy_convert: tukar model ke format fail lainmeshy_resize: ubah saiz model kepada dimensi dunia sebenarmeshy_uv_unwrap: jana susun atur UV baharu untuk model
Creative Lab
meshy_creative_lab: tukar foto menjadi produk Creative Lab yang siap (menjalankan tugas prototaip dan pembinaan)
Penjanaan Imej
meshy_text_to_image: imej 2D daripada teksmeshy_image_to_image: imej 2D daripada imej rujukan
Pengurusan Tugas
meshy_get_task_status: semak status tugas dan URL muat turunmeshy_list_tasks: senaraikan tugas terkini, boleh ditapis mengikut jenis/statusmeshy_cancel_task: padam tugas. TugasPENDINGdialih keluar dan dibayar balik; tugasIN_PROGRESStidak boleh dibatalkan (API memulangkan409); tugas yang telah selesai akan dipadam.meshy_download_model: dapatkan fail model yang telah siap dan simpan secara tempatan
Ruang Kerja
meshy_list_models: senaraikan model Teks ke 3D terkini anda (gunakanmeshy_list_tasksuntuk jenis tugas lain)
Pencetakan 3D
meshy_send_to_slicer: kesan slicer yang dipasang dan pulangkan arahan untuk membuka model di dalamnya (berjalan secara tempatan; tiada panggilan Meshy API)meshy_analyze_printability: pemeriksaan kebolehcetakan FDM automatik percuma (kekedapan air, isipadu, lubang, tepi non-manifold, muka degenerat)meshy_process_multicolor: tukar model bertekstur menjadi fail 3MF berbilang warna untuk pencetakanmeshy_repair_printability: baiki model untuk pencetakan FDM
Akaun
meshy_check_balance: pertanyaan baki kredit yang tinggal
Nama dan tingkah laku alat mungkin berkembang. Senarai yang berwibawa boleh didapati dalam sumber MCP server.
Contoh Prompt
Masukkan ini ke dalam sembang anda yang disokong MCP sebagai titik permulaan.
Generate a 3D fox from the prompt "a cartoon fox sitting", preview it, then
texture it with PBR maps. Download the final GLB to ./outputs.
Take the image at https://example.com/sculpture.jpg and convert it into a
riggable 3D character. Use `should_remesh: true` and 50k target polycount.
What's my current Meshy credit balance?
List my last 10 successful text-to-3d tasks and download the top 3 as GLB
into ./downloads/.
llms.txt dan llms-full.txt
Jika ejen anda tidak menyokong MCP, atau anda ingin menyerap dokumentasi Meshy terus ke dalam prompt, arahkannya ke permukaan teks biasa kami:
llms.txt— indeks ringkas + arahan integrasi (corak tinjauan async yang betul, peraturan pengesahan, had kadar, pemilihan model, kesilapan biasa).llms-full.txt— setiap halaman API digabungkan dalam satu fail untuk penyerapan satu-tarikan.- Markdown setiap halaman: tambah
.mdpada mana-mana URL endpoint. Contoh:https://docs.meshy.ai/api/text-to-3d.md.
Ketiga-tiganya dijana semula setiap kali laman dokumentasi dibina, jadi ia tidak pernah terpesong daripada dokumentasi HTML.
Soalan Lazim
- Adakah MCP server stateless?
- Ya. MESHY_API_KEY anda digunakan bagi setiap permintaan dan tidak pernah disimpan di sisi server.
- Adakah MCP dikenakan kos yang sama seperti API REST?
- Ya — setiap panggilan alat MCP dipetakan kepada satu panggilan REST dan menggunakan kredit pada kadar yang sama persis. Lihat laman Pricing untuk matriks penuh.
- Apakah had kadar yang dikenakan?
- MCP server berkongsi satah had kadar yang sama dengan API REST. Lihat laman Rate Limits untuk had mengikut setiap peringkat.
- Data Meshy manakah yang boleh diakses oleh MCP?
- Hanya apa yang boleh diakses oleh MESHY_API_KEY melalui REST. Skop dan kebenaran adalah sama.
- Bagaimana saya boleh melaporkan isu?
- Failkan isu di repositori meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues