Pelaksanaan praktikal adalah di mana kuasa Model Context Protocol (MCP) menjadi nyata. Walaupun memahami teori dan seni bina di sebalik MCP adalah penting, nilai sebenar muncul apabila anda menggunakan konsep ini untuk membina, menguji, dan melaksanakan penyelesaian yang menyelesaikan masalah dunia sebenar. Bab ini merapatkan jurang antara pengetahuan konseptual dan pembangunan praktikal, membimbing anda melalui proses membawa aplikasi berasaskan MCP menjadi kenyataan.
Sama ada anda membangunkan pembantu pintar, mengintegrasikan AI ke dalam aliran kerja perniagaan, atau membina alat khusus untuk pemprosesan data, MCP menyediakan asas yang fleksibel. Reka bentuknya yang bebas bahasa dan SDK rasmi untuk bahasa pengaturcaraan popular menjadikannya mudah diakses oleh pelbagai pembangun. Dengan memanfaatkan SDK ini, anda boleh dengan cepat membuat prototaip, mengulangi, dan mengembangkan penyelesaian anda merentasi pelbagai platform dan persekitaran.
Dalam bahagian berikut, anda akan menemui contoh praktikal, kod sampel, dan strategi pelaksanaan yang menunjukkan cara melaksanakan MCP dalam C#, Java, TypeScript, JavaScript, dan Python. Anda juga akan belajar cara untuk debug dan menguji pelayan MCP anda, mengurus API, dan melaksanakan penyelesaian ke awan menggunakan Azure. Sumber praktikal ini direka untuk mempercepatkan pembelajaran anda dan membantu anda membina aplikasi MCP yang kukuh dan sedia untuk produksi dengan yakin.
Pelajaran ini memfokuskan pada aspek praktikal pelaksanaan MCP merentasi pelbagai bahasa pengaturcaraan. Kita akan meneroka cara menggunakan MCP SDK dalam C#, Java, TypeScript, JavaScript, dan Python untuk membina aplikasi yang kukuh, debug dan uji pelayan MCP, serta mencipta sumber, prompt, dan alat yang boleh digunakan semula.
Menjelang akhir pelajaran ini, anda akan dapat:
- Melaksanakan penyelesaian MCP menggunakan SDK rasmi dalam pelbagai bahasa pengaturcaraan
- Debug dan uji pelayan MCP secara sistematik
- Cipta dan gunakan ciri pelayan (Sumber, Prompt, dan Alat)
- Reka aliran kerja MCP yang berkesan untuk tugasan kompleks
- Optimumkan pelaksanaan MCP untuk prestasi dan kebolehpercayaan
Model Context Protocol menawarkan SDK rasmi untuk pelbagai bahasa:
Bahagian ini menyediakan contoh praktikal pelaksanaan MCP merentasi pelbagai bahasa pengaturcaraan. Anda boleh menemui kod sampel dalam direktori samples yang disusun mengikut bahasa.
Repositori ini mengandungi pelaksanaan sampel dalam bahasa berikut:
Setiap sampel menunjukkan konsep utama MCP dan corak pelaksanaan untuk bahasa dan ekosistem tertentu.
Pelayan MCP boleh melaksanakan sebarang gabungan ciri berikut:
Sumber menyediakan konteks dan data untuk digunakan oleh pengguna atau model AI:
- Repositori dokumen
- Pangkalan pengetahuan
- Sumber data berstruktur
- Sistem fail
Prompt adalah mesej dan aliran kerja berasaskan templat untuk pengguna:
- Templat perbualan yang telah ditetapkan
- Corak interaksi berpandu
- Struktur dialog khusus
Alat adalah fungsi yang boleh dijalankan oleh model AI:
- Utiliti pemprosesan data
- Integrasi API luaran
- Keupayaan pengiraan
- Fungsi carian
Repositori SDK C# rasmi mengandungi beberapa pelaksanaan sampel yang menunjukkan pelbagai aspek MCP:
- Klien MCP Asas: Contoh mudah menunjukkan cara mencipta klien MCP dan memanggil alat
- Pelayan MCP Asas: Pelaksanaan pelayan minimum dengan pendaftaran alat asas
- Pelayan MCP Lanjutan: Pelayan lengkap dengan pendaftaran alat, pengesahan, dan pengendalian ralat
- Integrasi ASP.NET: Contoh yang menunjukkan integrasi dengan ASP.NET Core
- Corak Pelaksanaan Alat: Pelbagai corak untuk melaksanakan alat dengan tahap kerumitan berbeza
SDK MCP C# masih dalam pratonton dan API mungkin berubah. Kami akan sentiasa mengemas kini blog ini seiring evolusi SDK.
Untuk sampel pelaksanaan C# lengkap, lawati repositori sampel SDK C# rasmi
SDK Java menawarkan pilihan pelaksanaan MCP yang kukuh dengan ciri tahap perusahaan.
- Integrasi Spring Framework
- Keselamatan jenis yang kuat
- Sokongan pengaturcaraan reaktif
- Pengendalian ralat yang menyeluruh
Untuk sampel pelaksanaan Java lengkap, lihat sampel Java dalam direktori sampel.
SDK JavaScript menyediakan pendekatan ringan dan fleksibel untuk pelaksanaan MCP.
- Sokongan Node.js dan pelayar
- API berasaskan Promise
- Integrasi mudah dengan Express dan rangka kerja lain
- Sokongan WebSocket untuk penstriman
Untuk sampel pelaksanaan JavaScript lengkap, lihat sampel JavaScript dalam direktori sampel.
SDK Python menawarkan pendekatan Pythonik untuk pelaksanaan MCP dengan integrasi rangka kerja ML yang cemerlang.
- Sokongan async/await dengan asyncio
- Integrasi FastAPI
- Pendaftaran alat yang mudah
- Integrasi asli dengan perpustakaan ML popular
Untuk sampel pelaksanaan Python lengkap, lihat sampel Python dalam direktori sampel.
Azure API Management adalah jawapan terbaik untuk bagaimana kita boleh mengamankan Pelayan MCP. Idea ini adalah untuk meletakkan instans Azure API Management di hadapan Pelayan MCP anda dan membiarkannya mengendalikan ciri-ciri yang anda mungkin perlukan seperti:
- had kadar
- pengurusan token
- pemantauan
- pengimbangan beban
- keselamatan
Berikut adalah Sampel Azure yang melakukan perkara tersebut, iaitu mencipta Pelayan MCP dan mengamankannya dengan Azure API Management.
Lihat bagaimana aliran kebenaran berlaku dalam imej di bawah:
Dalam imej di atas, perkara berikut berlaku:
- Pengesahan/Kebenaran berlaku menggunakan Microsoft Entra.
- Azure API Management bertindak sebagai pintu masuk dan menggunakan polisi untuk mengarahkan dan mengurus trafik.
- Azure Monitor merekod semua permintaan untuk analisis lanjut.
Mari kita lihat aliran kebenaran dengan lebih terperinci:
Ketahui lebih lanjut mengenai spesifikasi Kebenaran MCP
Mari kita lihat jika kita boleh melaksanakan sampel yang disebutkan tadi:
-
Klon repositori
git clone https://github.com/Azure-Samples/remote-mcp-apim-functions-python.git cd remote-mcp-apim-functions-python -
Daftarkan penyedia sumber
Microsoft.App.- Jika anda menggunakan Azure CLI, jalankan
az provider register --namespace Microsoft.App --wait. - Jika anda menggunakan Azure PowerShell, jalankan
Register-AzResourceProvider -ProviderNamespace Microsoft.App. Kemudian jalankan(Get-AzResourceProvider -ProviderNamespace Microsoft.App).RegistrationStateselepas beberapa ketika untuk memeriksa sama ada pendaftaran selesai.
- Jika anda menggunakan Azure CLI, jalankan
-
Jalankan perintah azd ini untuk menyediakan perkhidmatan pengurusan API, aplikasi fungsi (dengan kod) dan semua sumber Azure lain yang diperlukan
azd up
Perintah ini sepatutnya melaksanakan semua sumber awan di Azure
-
Dalam tetingkap terminal baru, pasang dan jalankan MCP Inspector
npx @modelcontextprotocol/inspector
Anda sepatutnya melihat antara muka seperti:
-
CTRL klik untuk memuatkan aplikasi web MCP Inspector dari URL yang dipaparkan oleh aplikasi (contoh: http://127.0.0.1:6274/#resources)
-
Tetapkan jenis pengangkutan kepada
SSE -
Tetapkan URL ke titik akhir SSE Pengurusan API anda yang sedang berjalan yang dipaparkan selepas
azd updan Sambung:https://<apim-servicename-from-azd-output>.azure-api.net/mcp/sse
-
Senaraikan Alat. Klik pada alat dan Jalankan Alat.
Jika semua langkah berjaya, anda kini sepatutnya bersambung ke pelayan MCP dan berjaya memanggil alat.
Remote-mcp-functions: Set repositori ini adalah templat permulaan pantas untuk membina dan melaksanakan pelayan MCP jauh khusus menggunakan Azure Functions dengan Python, C# .NET atau Node/TypeScript.
Sampel ini menyediakan penyelesaian lengkap yang membolehkan pembangun untuk:
- Bina dan jalankan secara tempatan: Bangunkan dan debug pelayan MCP pada mesin tempatan
- Laksanakan ke Azure: Mudah melaksanakan ke awan dengan perintah azd up yang ringkas
- Sambung dari klien: Sambung ke pelayan MCP dari pelbagai klien termasuk mod ejen Copilot VS Code dan alat MCP Inspector
- Keselamatan secara reka bentuk: Pelayan MCP diamankan menggunakan kunci dan HTTPS
- Pilihan pengesahan: Menyokong OAuth menggunakan pengesahan terbina dalam dan/atau Pengurusan API
- Pengasingan rangkaian: Membenarkan pengasingan rangkaian menggunakan Rangkaian Maya Azure (VNET)
- Seni bina tanpa pelayan: Memanfaatkan Azure Functions untuk pelaksanaan berskala dan berasaskan acara
- Pembangunan tempatan: Sokongan pembangunan dan debug tempatan yang menyeluruh
- Pelaksanaan mudah: Proses pelaksanaan yang dipermudahkan ke Azure
Repositori ini mengandungi semua fail konfigurasi yang diperlukan, kod sumber, dan definisi infrastruktur untuk memulakan pelaksanaan pelayan MCP yang sedia untuk produksi dengan cepat.
-
Azure Remote MCP Functions Python - Pelaksanaan sampel MCP menggunakan Azure Functions dengan Python
-
Azure Remote MCP Functions .NET - Pelaksanaan sampel MCP menggunakan Azure Functions dengan C# .NET
-
Azure Remote MCP Functions Node/Typescript - Pelaksanaan sampel MCP menggunakan Azure Functions dengan Node/TypeScript.
- SDK MCP menyediakan alat khusus bahasa untuk melaksanakan penyelesaian MCP yang kukuh
- Proses debug dan ujian adalah kritikal untuk aplikasi MCP yang boleh dipercayai
- Templat prompt yang boleh digunakan semula membolehkan interaksi AI yang konsisten
- Aliran kerja yang direka dengan baik boleh mengatur tugasan kompleks menggunakan pelbagai alat
- Melaksanakan penyelesaian MCP memerlukan pertimbangan keselamatan, prestasi, dan pengendalian ralat
Reka aliran kerja MCP praktikal yang menangani masalah dunia sebenar dalam domain anda:
- Kenal pasti 3-4 alat yang berguna untuk menyelesaikan masalah ini
- Cipta rajah aliran kerja yang menunjukkan bagaimana alat-alat ini berinteraksi
- Laksanakan versi asas salah satu alat menggunakan bahasa pilihan anda
- Cipta templat prompt yang membantu model menggunakan alat anda dengan berkesan
Seterusnya: Topik Lanjutan
Penafian:
Dokumen ini telah diterjemahkan menggunakan perkhidmatan terjemahan AI Co-op Translator. Walaupun kami berusaha untuk ketepatan, sila ambil perhatian bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidaktepatan. Dokumen asal dalam bahasa asalnya harus dianggap sebagai sumber yang sahih. Untuk maklumat penting, terjemahan profesional oleh manusia adalah disyorkan. Kami tidak bertanggungjawab atas sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini.