Integrasi AI

Meshy menyediakan dua saluran untuk agen AI dan pembantu pengekodan: server Meshy MCP untuk pemanggilan alat, dan llms.txt / llms-full.txt untuk pengambilan dokumen.

Jika anda mengintegrasikan Meshy dari Claude Code, Cursor, Windsurf, Codex, atau mana-mana alat yang serasi dengan MCP, pasang server MCP di bawah. Jika anda mengintegrasikan dari agen sembang biasa tanpa sokongan MCP, arahkan ia ke https://docs.meshy.cn/llms.txt sebaliknya.

Apa itu MCP

Model Context Protocol (MCP) adalah standard terbuka yang membolehkan pembantu AI memanggil alat luaran dan mendapatkan konteks berstruktur. Server Meshy MCP membungkus Meshy REST API sebagai satu set alat yang boleh dipanggil oleh agen anda — menjana model, memeriksa tugas, memuat turun hasil — tanpa menulis kod HTTP secara manual.

Server MCP 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 https://www.meshy.ai/settings/api. Server MCP membacanya dari 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 drop-in? Pek kemahiran sumber terbuka meshy-3d-agent menyediakan aliran kerja Meshy yang telah ditulis terlebih dahulu (menjana → memeriksa → memuat turun) untuk Claude Code, Cursor, dan OpenClaw. Ia memanggil Meshy REST API secara langsung — tidak memerlukan server MCP.

npx skills add meshy-dev/meshy-3d-agent

Alat yang Tersedia

Server MCP mendedahkan Meshy REST API sebagai alat, dikelompokkan mengikut keupayaan.

Penjanaan 3D

  • meshy_text_to_3d — mencipta model 3D daripada prompt teks
  • meshy_image_to_3d — mencipta model 3D daripada satu imej
  • meshy_multi_image_to_3d — mencipta model 3D daripada pelbagai imej objek yang sama
  • meshy_text_to_3d_refine — menambah tekstur kepada jejaring pratonton

Pemprosesan Selepas

  • meshy_remesh — menukar topology dan/atau bilangan poligon model sedia ada
  • meshy_retexture — menggunakan tekstur baru kepada model sedia ada
  • meshy_rig — menambah rangka kepada watak humanoid 3D
  • meshy_animate — menggunakan animasi kepada watak yang telah dirangka

Penjanaan Imej

  • meshy_text_to_image — imej 2D daripada teks
  • meshy_image_to_image — imej 2D daripada imej rujukan

Pengurusan Tugas

  • meshy_get_task_status — memeriksa status tugas dan URL muat turun
  • meshy_list_tasks — menyenaraikan tugas terkini, boleh ditapis mengikut jenis/status
  • meshy_cancel_task — membatalkan tugas yang tertunda atau dalam progress
  • meshy_download_model — mendapatkan fail model yang telah siap dan menyimpannya secara tempatan

Ruang Kerja

  • meshy_list_models — menyenaraikan semua model dalam ruang kerja pengguna yang disahkan

Pencetakan 3D

  • meshy_send_to_slicer — mengesan slicer yang dipasang dan melancarkan model dalam satu (berjalan secara tempatan pada mesin anda; tiada panggilan Meshy API)
  • meshy_analyze_printability — kini mengembalikan senarai semak kesediaan cetak manual (ketebalan dinding, overhang, jejaring manifold, dll.). Akan dinaik taraf kepada analisis automatik sebaik sahaja Meshy printability API tersedia.
  • meshy_process_multicolor — menukar model bertekstur kepada fail 3MF berwarna-warni untuk pencetakan

Akaun

  • meshy_check_balance — menyemak baki kredit yang tinggal

Nama dan tingkah laku alat mungkin berubah. Senarai yang berwibawa terdapat dalam sumber server MCP.

Contoh Prompt

Masukkan ini ke dalam sembang yang diaktifkan MCP anda 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 agen anda tidak menyokong MCP, atau anda ingin mengambil dokumen Meshy ke dalam prompt secara langsung, arahkan ia ke permukaan teks biasa kami:

  • llms.txt — indeks padat + arahan integrasi (corak async-polling yang betul, peraturan pengesahan, had kadar, pilihan model, kesilapan biasa).
  • llms-full.txt — setiap halaman API digabungkan dalam satu fail untuk pengambilan sekali.
  • Markdown per halaman: tambahkan .md kepada mana-mana URL endpoint. Contoh: https://docs.meshy.cn/api/text-to-3d.md.

Ketiga-tiga ini dijana semula setiap kali laman dokumen dibina, jadi mereka tidak pernah menyimpang dari dokumen HTML.

Soalan Lazim

Adakah server MCP tidak mempunyai status?
Ya. MESHY_API_KEY anda digunakan setiap permintaan dan tidak pernah disimpan di sisi server.
Adakah MCP berharga sama seperti REST API?
Ya — setiap panggilan alat MCP memetakan kepada satu panggilan REST dan menggunakan kredit pada kadar yang sama. Lihat halaman Harga untuk matriks penuh.
Apakah had kadar?
Server MCP berkongsi pesawat had kadar yang sama dengan REST API. Lihat halaman Had Kadar untuk had per-tier.
Apakah data Meshy yang boleh diakses oleh MCP?
Hanya apa yang MESHY_API_KEY boleh akses melalui REST. Skop dan kebenaran adalah sama.
Bagaimana saya melaporkan isu?
Failkan isu di repositori meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues