YepCode MCP Server

resmi

YepCode güvenli ve ölçeklenebilir sandbox ortamında herhangi bir LLM tarafından oluşturulan kodu çalıştırın ve JavaScript veya Python kullanarak kendi MCP araçlarınızı oluşturun; NPM ve PyPI paketleri için tam destek sağlar.

GitHub
43

Dokümantasyon

YepCode MCP Server Preview

NPM version NPM Downloads GitHub Workflow Status

Trust Score smithery badge

YepCode MCP Sunucusu Nedir?

Yapay zeka platformlarının YepCode altyapısıyla etkileşime girmesini sağlayan bir MCP (Model Bağlam Protokolü) sunucusu. LLM tarafından oluşturulan betikleri çalıştırın ve YepCode süreçlerinizi yapay zeka asistanlarının doğrudan kullanabileceği güçlü araçlara dönüştürün. YepCode, dinamik bir MCP araç sunucusu oluşturmak için mükemmel bir ortamdır: her süreci bir araç olarak sunun (OAuth, API belirteçleri veya kimlik bilgilerinizle), her aracın parametrelerini tam esneklik için JSON Şeması ile tanımlayın ve araçları Python veya Node.js ile uygulayın—hepsi birden çok dili harmanlayan tek bir sunucuda.

Neden YepCode MCP Sunucusu?

  • Kusursuz Yapay Zeka Entegrasyonu: YepCode süreçlerini sıfır yapılandırma ile yapay zekaya hazır araçlara dönüştürün
  • Gerçek Zamanlı Süreç Kontrolü: Yapay zeka sistemleri ile iş akışlarınız arasında doğrudan etkileşimi etkinleştirin
  • Kurumsal Düzeyde Güvenlik: Kodu YepCode'un yalıtılmış, üretime hazır ortamlarında çalıştırın
  • Evrensel Uyumluluk: Model Bağlam Protokolünü destekleyen herhangi bir yapay zeka platformuyla entegre edin

YepCode: Dinamik Bir MCP Araç Sunucusu İçin Mükemmel Ortam

YepCode, dinamik bir MCP araç sunucusu çalıştırmak için ideal platform olacak şekilde inşa edilmiştir:

  • Bir süreç, bir araç: Her YepCode süreci bir MCP aracı olarak sunulabilir. Süreçlerinizi etiketleyin (ör. mcp-tool, core, automation) ve bunlar yapay zeka asistanlarının çağırabileceği araçlar haline gelir. Erişimi OAuth, API belirteçleri veya mevcut YepCode kimlik bilgilerinizle güvence altına alabilirsiniz—her araç aynı güvenlik modeliyle çalışma alanınızda çalışır.

  • Araç parametreleri üzerinde tam kontrol: Her araç kendi parametre şemasını JSON Şeması olarak tanımlayabilir. Girdileri (türler, açıklamalar, zorunlu alanlar, enumlar, varsayılanlar vb.) tanımlamak için tam esneklik elde edersiniz, böylece yapay zeka zengin meta veriler alır ve araçlarınızı doğru şekilde çağırabilir.

  • Çok dilli araç uygulamaları: Araçları Python veya Node.js (veya her ikisi) ile uygulayın. Aynı MCP sunucusu, farklı çalışma zamanları tarafından desteklenen araçları sunabilir—bunu, birden çok dilde uygulamaları harmanlayan tek bir MCP sunucusu olarak düşünün.

Tam belgeler için YepCode MCP Sunucusu belgelerine bakın.

Kurulum

Bu paket, YepCode MCP sunucusunu yerel olarak veya kendi altyapınızda (NPX, Docker veya özel dağıtım) çalıştırmanıza olanak tanır. Cursor veya Claude Desktop gibi yapay zeka platformlarıyla entegre edin.

İpucu: YepCode hesabınızdan, yerel kurulum gerektirmeyen barındırılan bir MCP sunucusuna da erişebilirsiniz. Bağlantı URL'si her zaman: https://cloud.yepcode.io/mcp

Ön Koşullar

YepCode API kimlik bilgilerinizi edinin:

  1. YepCode Cloud'a kaydolun
  2. Yeni bir API belirteci oluşturmak için Settings > API credentials adresini ziyaret edin.

NPX Kullanarak

Node.js'in kurulu olduğundan emin olun (sürüm 18 veya üstü) ve aşağıdakine benzer bir yapılandırma kullanın:

{
  "mcpServers": {
    "yepcode-mcp-server": {
      "command": "npx",
      "args": ["-y", "@yepcode/mcp-server"],
      "env": {
        "YEPCODE_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Docker Kullanarak

  1. Konteyner imajını oluşturun:
docker build -t yepcode/mcp-server .
  1. Aşağıdakine benzer bir yapılandırma kullanın:
{
  "mcpServers": {
    "yepcode-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-d",
        "-e",
        "YEPCODE_API_TOKEN=your_api_token_here",
        "yepcode/mcp-server"
      ]
    }
  }
}

Hata Ayıklama

MCP sunucularında hata ayıklamak, stdio üzerinden iletişim kurdukları için zor olabilir. Bunu kolaylaştırmak için, aşağıdaki komutla çalıştırabileceğiniz MCP Inspector aracını kullanmanızı öneririz:

npm run inspector

Bu, hata ayıklama araçlarına doğrudan tarayıcınızdan erişebileceğiniz bir sunucu başlatacaktır.

YepCode MCP Araç Referansı

MCP sunucusu, YepCode altyapısıyla etkileşim kurmak için çeşitli araçlar sağlar:

Kod Yürütme

run_code

YepCode'un güvenli ortamında kod yürütür.

// Input
{
  code: string;                          // The code to execute
  options?: {
    language?: string;                   // Programming language (default: 'javascript')
    comment?: string;                    // Execution context
    settings?: Record<string, unknown>;  // Runtime settings
  }
}

// Response
{
  returnValue?: unknown;                 // Execution result
  logs?: string[];                       // Console output
  error?: string;                        // Error message if execution failed
}
MCP Seçenekleri

YepCode MCP sunucusu aşağıdaki seçenekleri destekler:

  • runCodeCleanup: run_code temizliğini atlayın. Varsayılan olarak, run_code süreçlerinin kaynak kodu yürütmeden sonra kaldırılır. Denetim amacıyla saklamak isterseniz bu seçeneği kullanabilirsiniz.
  • skipCodingRules: run_code araç tanımına kodlama kurallarını dahil etmeyi atlayın. Varsayılan olarak, yapay zeka tarafından oluşturulan koda rehberlik etmesi için YepCode belgelerindeki JavaScript ve Python kodlama kuralları araç şemasına dahil edilir. Daha hızlı araç başlatma veya daha küçük araç tanımları için bunu atlamak isterseniz bu seçeneği kullanabilirsiniz.

Seçenekler, YEPCODE_MCP_OPTIONS ortam değişkeninde virgülle ayrılmış bir liste olarak iletilebilir.

Araç Seçimi

YEPCODE_MCP_TOOLS ortam değişkenini, araç kategorileri ve süreç etiketlerinden oluşan virgülle ayrılmış bir liste ile ayarlayarak hangi araçların etkinleştirileceğini kontrol edebilirsiniz:

Yerleşik araç kategorileri:

  • run_code: Kod yürütme aracını etkinleştirir
  • yc_api: Tüm temel API yönetim araçlarını etkinleştirir (süreçler, zamanlamalar, değişkenler, depolama, yürütmeler, modüller)
  • yc_api_full: Sürümle ilgili araçlar dahil tüm API yönetim araçlarını etkinleştirir (ek süreç ve modül sürüm yönetimi araçlarıyla yc_api'i genişletir)
  • herhangi bir belirli API aracı adı (ör. execute_process_sync, get_execution, ...)

Süreç etiketleri:

  • YepCode süreçlerinizde kullanılan herhangi bir etiket (ör. mcp-tool, core, automation, vb.)
  • Bir süreç etiketi belirttiğinizde, bu etikete sahip tüm süreçler bireysel MCP araçları olarak sunulur
  • Süreç araçları, süreç slug'ı kullanılarak adlandırılır (veya ad 60 karakterden uzunsa yc_ ve süreç kimliği ile ön eklenir)

Belirtilmezse, varsayılan olarak tüm yerleşik araçlar etkinleştirilir, ancak hiçbir süreç aracı sunulmaz.

// NPX configuration with options
{
  "mcpServers": {
    "yepcode-mcp-server": {
      "command": "npx",
      "args": ["-y", "@yepcode/mcp-server"],
      "env": {
        "YEPCODE_API_TOKEN": "your_api_token_here",
        "YEPCODE_MCP_OPTIONS": "runCodeCleanup,skipCodingRules",
        "YEPCODE_MCP_TOOLS": "run_code,yc_api,mcp-tool,core"
      }
    }
  }
}

Örnek senaryolar:

  • YEPCODE_MCP_TOOLS=run_code,yc_api - Yerleşik kod yürütme ve temel API yönetim araçlarını etkinleştirir
  • YEPCODE_MCP_TOOLS=run_code,yc_api_full - Yerleşik kod yürütme ve tüm API yönetim araçlarını (sürüm yönetimi dahil) etkinleştirir
  • YEPCODE_MCP_TOOLS=core,automation - Yalnızca "core" veya "automation" ile etiketlenmiş süreçleri araç olarak sunar
  • YEPCODE_MCP_TOOLS=run_code,yc_api,core - Yerleşik araçları ve "core" ile etiketlenmiş tüm süreçleri etkinleştirir

Ortam Yönetimi

set_env_var

YepCode çalışma alanında bir ortam değişkeni ayarlar.

// Input
{
  key: string;                           // Variable name
  value: string;                         // Variable value
  isSensitive?: boolean;                 // Whether to mask the value in logs (default: true)
}

remove_env_var

YepCode çalışma alanından bir ortam değişkenini kaldırır.

// Input
{
  key: string;                           // Name of the variable to remove
}

Depolama Yönetimi

YepCode, dosya yüklemenize, listelemenize, indirmenize ve silmenize olanak tanıyan yerleşik bir depolama sistemi sağlar. Bu dosyalara, kod yürütmelerinizden yepcode.storage yardımcı yöntemlerini kullanarak erişilebilir.

list_files

YepCode depolamanızdaki tüm dosyaları listeler.

// Input
{
  prefix?: string;                       // Optional prefix to filter files
}

// Response
{
  files: Array<{
    filename: string;                    // File name or path
    size: number;                        // File size in bytes
    lastModified: string;                // Last modification date
  }>;
}

upload_file

YepCode depolamasına bir dosya yükler.

// Input
{
  filename: string;                      // File path (e.g., 'file.txt' or 'folder/file.txt')
  content: string | {                   // File content
    data: string;                        // Base64 encoded content for binary files
    encoding: "base64";
  };
}

// Response
{
  success: boolean;                      // Upload success status
  filename: string;                      // Uploaded file path
}

download_file

YepCode depolamasından bir dosya indirir.

// Input
{
  filename: string;                      // File path to download
}

// Response
{
  filename: string;                      // File path
  content: string;                       // File content (base64 for binary files)
  encoding?: string;                     // Encoding type if binary
}

delete_file

YepCode depolamasından bir dosya siler.

// Input
{
  filename: string;                      // File path to delete
}

// Response
{
  success: boolean;                      // Deletion success status
  filename: string;                      // Deleted file path
}

Süreç Yürütme

MCP sunucusu, YepCode Süreçlerinizi bireysel MCP araçları olarak sunabilir ve bunları yapay zeka asistanları için doğrudan erişilebilir hale getirir. Bu özellik, YEPCODE_MCP_TOOLS ortam değişkeninde süreç etiketleri belirtilerek etkinleştirilir.

Nasıl çalışır:

  1. YepCode süreçlerinizi herhangi bir etiketle etiketleyin (ör. core, api, automation, mcp-tool, vb.)
  2. Bu etiketleri YEPCODE_MCP_TOOLS ortam değişkenine ekleyin
  3. Belirtilen etiketlere sahip tüm süreçler bireysel MCP araçları olarak sunulur

Her bir sunulan süreç için, süreç slug'ı kullanılarak adlandırılan bir araç olacaktır (veya araç adı 60 karakterden uzunsa yc_ ve süreç kimliği ile ön eklenir).

Süreç etiketleri hakkında daha fazla bilgi için süreç etiketleri belgelerimize bakın.

<process_slug>

// Input
{
  parameters?: any;                      // This should match the input parameters specified in the process
  options?: {
    tag?: string;                        // Process version to execute
    comment?: string;                    // Execution context
  };
  synchronousExecution?: boolean;        // Whether to wait for completion (default: true)
}

// Response (synchronous execution)
{
  executionId: string;                   // Unique execution identifier
  logs: string[];                        // Process execution logs
  returnValue?: unknown;                 // Process output
  error?: string;                        // Error message if execution failed
}

// Response (asynchronous execution)
{
  executionId: string;                   // Unique execution identifier
}

API Yönetim Araçları

API yönetim aracı kategorileri (yc_api ve yc_api_full), YepCode çalışma alanınızın tüm yönlerini yönetmek için kapsamlı API erişimi sağlar:

Temel API araçları (yc_api): yc_api etiketi, çalışma alanınızdaki temel işlemler için standart API yönetim araçlarını etkinleştirir.

Genişletilmiş API araçları (yc_api_full): yc_api_full etiketi, yc_api'deki her şeyi ve ayrıca süreç ve modül sürümlerini yönetmek için ek araçları içerir.

Süreç Yönetimi:

  • get_processes - İsteğe bağlı filtreleme ile süreçleri listele
  • create_process - Kaynak koduyla yeni süreçler oluştur
  • get_process - Süreç ayrıntılarını al
  • update_process - Mevcut bir süreci güncelle
  • delete_process - Bir süreci sil
  • get_process_versions - Süreç sürümlerini al (yc_api_full gerektirir)
  • execute_process_async - Bir süreci eşzamansız olarak yürüt
  • execute_process_sync - Bir süreci eşzamanlı olarak yürüt
  • schedule_process - Bir sürecin otomatik olarak çalışmasını zamanla

Zamanlama Yönetimi:

  • get_schedules - Zamanlanmış süreçleri listele
  • get_schedule - Zamanlama ayrıntılarını al
  • pause_schedule - Zamanlanmış bir süreci duraklat
  • resume_schedule - Duraklatılmış bir zamanlamayı sürdür
  • delete_schedule - Bir zamanlamayı sil
  • update_schedule - Zamanlanmış bir süreci güncelle

Değişken Yönetimi:

  • get_variables - Takım değişkenlerini listele
  • create_variable - Yeni bir değişken oluştur
  • update_variable - Mevcut bir değişkeni güncelle
  • delete_variable - Bir değişkeni sil

Depolama Yönetimi:

  • get_storage_objects - Depolama nesnelerini listele
  • upload_storage_object - Depolamaya bir dosya yükle
  • download_storage_object - Depolamadan bir dosya indir
  • delete_storage_object - Depolamadan bir dosya sil

Yürütme Yönetimi:

  • get_executions - İsteğe bağlı filtreleme ile yürütmeleri listele
  • get_execution - API'den yürütme ayrıntılarını al
  • kill_execution - Çalışan bir yürütmeyi sonlandır
  • rerun_execution - Önceki bir yürütmeyi yeniden çalıştır
  • get_execution_logs - Yürütme günlüklerini al

Modül Yönetimi:

  • get_modules - Betik kütüphanesi modüllerini listele
  • create_module - Yeni bir modül oluştur
  • get_module - Modül ayrıntılarını al
  • delete_module - Bir modülü sil
  • get_module_versions - Modül sürümlerini al (yc_api_full gerektirir)
  • get_module_version - Belirli bir modül sürümünü al (yc_api_full gerektirir)
  • delete_module_version - Bir modül sürümünü sil (yc_api_full gerektirir)
  • get_module_aliases - Modül sürüm takma adlarını al (yc_api_full gerektirir)

Lisans

Bu proje MIT Lisansı altında lisanslanmıştır - ayrıntılar için LICENSE dosyasına bakın.