MCP Adapter

Açıklama

AI Building Blocks for WordPress girişiminin bir parçasıdır.

MCP Adapter, WordPress’in Yetenekler API’si ile Model Context Protocol (MCP) belirtimi arasında köprü kurarak yapay zekâ aracılarının WordPress işlevleriyle etkileşime girmesi için standartlaştırılmış bir yol sağlar. HTTP ve STDIO aktarım desteği, kapsamlı hata yönetimi ve özel entegrasyonlar için genişletilebilir bir mimari içerir.

Özellikler:

  • Yetenekten MCP’ye dönüştürme – WordPress yeteneklerini otomatik olarak MCP araçlarına, kaynaklarına ve komut istemlerine dönüştürür.
  • Çoklu sunucu yönetimi – Benzersiz yapılandırmalara sahip birden fazla MCP sunucusu oluşturun ve yönetin.
  • Genişletilebilir aktarım katmanı – Yerleşik HTTP ve STDIO aktarımlarının yanı sıra özel aktarım protokolleri için destek.
  • Esnek hata yönetimi – Özel, sunucuya özgü işleyici desteğiyle varsayılan WordPress uyumlu hata günlük kaydı.
  • Gözlemlenebilirlik – Yapılandırılabilir işleyicilerle sıfır ek yüklü metrik takibi.
  • İzin denetimi – Dışa aktarılan tüm işlevler için ayrıntılı, yapılandırılabilir izin denetimi.

Yükleme

  1. WordPress yönetim panelinizde Eklentiler > Yeni Ekle bölümüne gidin, “MCP Adapter” araması yapın ve Şimdi Kur düğmesine tıklayın.
  2. Eklentiyi WordPress’teki ‘Eklentiler’ ekranından etkinleştirin.
  3. Sunmak istediğiniz yetenekleri kaydedin veya bunları sizin yerinize kaydeden bir eklenti yükleyin.

Eklenti ZIP dosyasını Eklentiler > Yeni Ekle > Eklenti Yükle yoluyla da yükleyebilir veya WP-CLI ile kurabilirsiniz:

wp plugin install mcp-adapter --activate

SSS

MCP nedir?

Model Context Protocol (Model Bağlam Protokolü), yapay zekâ aracılarını harici sistemlere bağlamaya yönelik açık bir standarttır. Her yapay zekâ istemcisinin kendi özel entegrasyonuna ihtiyaç duyması yerine, bir sistem yapabildiklerini MCP araçları, kaynakları ve istemleri olarak sunar ve MCP uyumlu herhangi bir istemci bunları kullanabilir. Belirtim için bkz. modelcontextprotocol.io.

MCP Adapter nedir?

MCP Adapter, sunucu ve aktarım katmanıdır. Kendi başına herhangi bir yapay zekâ özelliği sağlamaz.

Sunduğu şeyler WordPress Yetenekler API’sinden gelir. Yetenek, yazıları okumak veya bir ayarı güncellemek gibi WordPress çekirdeği ya da başka bir eklenti tarafından kaydedilen tek bir kabiliyettir. MCP Adapter, sitenizde kayıtlı yetenekleri alır, bunları MCP istemcilerinin kullanımına sunar ve protokol anlaşmasını, izinleri ve hata yönetimini üstlenir.

Bu, bunun yararlı olması için çekirdekten veya kendi yeteneklerini kaydeden bir eklentiden gelen yeteneklerin de sitede bulunması gerektiği anlamına gelir.

Yapay zekâ aracıları siteme nasıl bağlanır?

Bağdaştırıcı, yerleşik HTTP aktarımı üzerinden MCP uç noktalarını kaydeder. MCP uyumlu bir istemciyi uç noktaya yönlendirin ve bir WordPress kullanıcısı olarak kimlik doğrulaması yapın. Bağdaştırıcı, tam olarak 2025-11-25 ve 2026-07-28 MCP sürümlerini destekler. Uç nokta ayrıntıları için başlangıç kılavuzuna bakın.

Kayıtlı her yetenek otomatik olarak sunulur mu?

Hayır, dışa aktarma isteğe bağlıdır. Bir yeteneğe yalnızca herkese açık olarak işaretlenmişse MCP üzerinden erişilebilir ve herhangi bir şey yürütülmeden önce geçerli kullanıcı için izin denetimleri çalışmaya devam eder. Yetenekleri nasıl etkinleştireceğinizi ve devre dışı bırakacağınızı öğrenmek için belgelere bakın.

Hataları nereden bildirebilirim veya özellikleri nereden talep edebilirim?

GitHub deposu üzerinden. Güvenlik sorunları herkese açık olarak bildirilmek yerine SECURITY.md dosyasındaki süreci izlemelidir.

Eklenti geliştiricileri, eklenti üstbilgilerine Requires Plugins: mcp-adapter ekleyerek MCP Adapter’a bağımlılık tanımlamalıdır. WP-CLI ve wp-env seçenekleri için BENİOKU dosyasına bakın.

İncelemeler

0 incelemeyi oku

Katkıda Bulunanlar ve Geliştiriciler

“MCP Adapter” açık kaynaklı yazılımdır. Aşağıdaki kişiler bu eklentiye katkıda bulunmuşlardır.

Katkıda bulunanlar

“MCP Adapter” 6 dile çevrildi. Katkıda bulundukları için çevirmenlere teşekkürler.

“MCP Adapter” eklentisini dilinize çevirin.

Geliştirmeyle ilgilenir misiniz?

Kodu görüntüleyin, SVN deposuna göz atın ya da RSS ile geliştirme günlüğüne abone olun.

Değişiklik Kaydı

0.7.1 – 2026-10-15

Düzeltildi

  • Depolanan oturum başlatma parametrelerini 4 KiB ile sınırlayın ve aşırı büyük oturum verilerini otomatik olarak kurtararak tekrarlanan veritabanı hatalarını ve aşırı günlük kaydını önleyin. Etkilenen istemcilerin bir kez yeniden bağlanması gerekir. Büyük satır içi simgelerin bağlantıları engellememesi için istemci simgeleri depolamadan hariç tutulur.
  • Daha eski bir paketlenmiş sınıf yüklenmeden önce sürüm seçimine izin vererek, paketlenmiş kopyaları denetlemeden önce kurulu eklentinin otomatik yükleyicisini kaydedin.
  • MCP istemcilerinden gelen bilinmeyen yetenek adları artık WordPress geliştirici bildirimleri oluşturmaz.

Değiştirildi

  • Kullanılamayan yetenekler, ilgili mevcut yetenek adlarını veya keşfetmeye yönelik bir ipucunu içeren daha net hatalar döndürür. MCP üzerinden sunulmayan yetenekler, bilinmeyen adlarla aynı ability_not_found hatasını döndürür.

Eklendi

  • Bir site sahibi rehberi bir yapay zekâ istemcisi bağlamayı, uygulama parolalarını ve sorun gidermeyi kapsar.

0.7.0 – 2026-10-02

Önemli değişiklikler

  • Bağdaştırıcı tam olarak iki MCP şema revizyonuna hizmet verir: 2025-11-25 ve 2026-07-28. 2025-06-18 veya 2024-11-05 öneren istemciler bağlanmaya devam eder ve 2025-11-25 şeması üzerinden hizmet alır.
  • Oluşturulan DTO sınıfları, McpToolValidator, McpResourceValidator ve McpPromptValidator sınıfları ve mcp_adapter_validation_enabled filtresi kaldırıldı. Ağ doğrulaması her zaman seçilen şema üzerinden çalışır.
  • Geçersiz protokol alanları artık sessizce yok sayılmıyor veya onarılmıyor. Desteklenen hiçbir revizyonun temsil edemediği bileşenler reddedilir.
  • Özel aktarımlar HttpRequestHandler veya McpWireOrchestrator bileşenlerine devredilmelidir. JSON-RPC toplu istekleri reddedilir.
  • WP\\MCP\\Cli sınıfları final olarak işaretlendi.

Eklendi

  • Oturumsuz server/discover yaşam döngüsü ve yeni HTTP başlıkları dahil MCP 2026-07-28 desteği.
  • Doğrudan çağrılabilir araçlar, McpInputRequired döndürerek 2026-07-28 kapsamında açımlama girdisi isteyebilir.
  • Seçilen şema, aktarım ve oturum verilerini içeren, istek başına değişmez bir bağlam olan McpRequestContext.

Değiştirildi

  • MCP Adapter’ı paketlenmiş bir kütüphane olarak kullanımdan kaldırıldı. Bunun yerine MCP Adapter eklentisini kurun.

Düzeltildi

  • mcp-adapter/get-ability-info boş bir input_schema değerini [] yerine {} olarak serileştirir.
  • Başka bir eklenti, MCP sunucusu başlatılmadan önce Abilities API’yi başlattığında varsayılan yetenekler kaydedilir.

Değişikliklerin tam listesi için 0.7.0 geçiş kılavuzuna ve CHANGELOG.md dosyasına bakın.

0.6.1 – 2026-08-13

Düzeltildi

  • Sürüm ZIP dosyası artık ZIP’in dışarıda bıraktığı dosyalara işaret eden bir Jetpack Autoloader sınıf haritası içermiyor. 0.6.0 sürümünde sınıf haritası, WP_CLI ve WP_CLI_Command dahil olmak üzere yalnızca test amaçlı genel sınıfları listeliyor ve bunları sürüm yapıtının hariç tuttuğu tests/phpunit/ altındaki dosyalarla eşleştiriyordu. Bu nedenle normal bir web isteğinde class_exists( 'WP_CLI' ) çağrısı yapan herhangi bir eklenti, yakalanmayan bir ölümcül hatayı tetikleyebiliyordu. class_exists( 'WP_CLI' ) artık WP-CLI kullanılamadığında false döndürüyor (#283).

Hiçbir API, kanca veya protokol davranışı değişmedi. 0.6.0 sürümünden yükseltme yapmak herhangi bir geçiş gerektirmez. Kaynaktan derlenen veya Composer aracılığıyla dahil edilen kurulumlar etkilenmedi.

0.6.0 – 2026-08-12

Önemli değişiklikler

  • Artık WordPress 6.9 veya daha yenisi gerekiyor. Bağımsız Abilities API eklentisi artık desteklenen bir yükleme yolu değildir.
  • meta.public: true değerine sahip yetenekler, meta.mcp.public açıkça devre dışı bırakmadığı sürece artık varsayılan MCP sunucusu üzerinden sunulur. Mevcut izin geri çağrıları ve yetenek denetimleri geçerliliğini korur.
  • Yalnızca çoklu sitede, oturum depolaması ağ genelindeki bir anahtardan ayrı site başına anahtarlara taşındığı için etkin Akış yapılabilir (Streamable) HTTP oturumlarının yükseltmeden sonra bir kez yeniden bağlanması gerekir. Tek siteli kurulumlar bundan etkilenmez.
  • Daha önce McpValidator tarafından sunulan MIME doğrulama yardımcıları kaldırıldı. Bunları doğrudan çağıran entegrasyonlar kendi uygulamaya özel MIME doğrulamalarını uygulamalıdır.

Eklendi

  • Kullanılabilir şablon olmadığında boş bir şablon listesi döndüren resources/templates/list desteği.
  • Eklenti PHP dosyalarının doğrudan çalıştırılması engellendi.
  • Genişletilmiş otomatik uyumluluk, bağımlılık ve Plugin Check kapsamı.

Değiştirildi

  • Bağımsız adaptör ile başka bir eklenti farklı sürümleri paketlediğinde mevcut en yeni WP\\MCP sınıflarının geçerli olması için artık Jetpack Autoloader kullanılıyor.
  • WordPress çoklu sitede oturum depolama alanı site (blog) bazında sınırlandırıldı.
  • Eşzamanlı oturum değişiklikleri sınırlı yeniden denemelerle korunarak bir isteğin başka bir oturumun üzerine yazma riski azaltılıyor.
  • Belgeler, Yetenekler API’sinin (Abilities API) WordPress 6.9 ve daha yeni sürümlerde yer aldığını açıklığa kavuşturuyor, zorunlu yetenek category alanını belgeliyor ve baştan sona örnekleri geliştiriyor.

Düzeltildi

  • _meta; kaynak içeriklerinde, gömülü kaynaklarda, içerik bloklarında ve istem mesajlarında korunur.
  • Bozuk biçimlendirilmiş _meta, birlikte bulunduğu veri yükü atılmadan yok sayılır.
  • mimeType, text/html;profile=mcp-app gibi parametreli değerler de dahil olmak üzere tam olarak bildirildiği gibi iletilir.
  • Yalnızca blob içeren kaynak içerikleri doğru şekilde işlenir.
  • Kaynak URI şemaları büyük/küçük harfe duyarsız olarak eşleştirilir; böylece istemciler şemayı küçük harfe normalleştirseler bile kaynakları okuyabilir.
  • Şema tanımlayan yetenekler için boş bağımsız değişkenler normalleştirilerek geçerli sıfır bağımsız değişkenli araç çağrılarının yürütülmesine izin verilir.
  • wp mcp-adapter serve, varsayılan sunucu seçilirken JSON-RPC stdout çıkışını temiz tutar.
  • Çakışan bir yerel seçenek kaydetmek yerine WP-CLI’ın genel --user bağımsız değişkeni kullanılır.

Daha eski sürümler için CHANGELOG.md dosyasına bakın.