MockStdioResponsePlugin

Model Bağlam Protokolü (MCP) sunucuları gibi STDIO tabanlı uygulamalar için yanıtları simüle eder.

Eklenti örneği tanımı

{
  "name": "MockStdioResponsePlugin",
  "enabled": true,
  "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
  "configSection": "mockStdioResponsePlugin"
}

Yapılandırma örneği

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.2.0/rc.schema.json",
  "plugins": [
    {
      "name": "MockStdioResponsePlugin",
      "enabled": true,
      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
      "configSection": "mockStdioResponsePlugin"
    }
  ],
  "mockStdioResponsePlugin": {
    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.2.0/mockstdioresponseplugin.schema.json",
    "mocksFile": "stdio-mocks.json"
  }
}

Yapılandırma özellikleri

Mülkiyet	Description	Varsayılan
mocksFile	STDIO sahte yanıtlarını içeren dosyanın yolu	stdio-mocks.json
blockUnmockedRequests	olduğunda true, eşleşmeyen stdin'in alt işleme ulaşmasını engeller	false

Komut satırı seçenekleri

İsim	Description	Varsayılan
--no-stdio-mocks	STDIO sahte yanıtlarını yüklemeyi devre dışı bırakma	false
--stdio-mocks-file	STDIO sahte yanıtlarını içeren dosyanın yolu	-

Sahte dosya örnekleri

Aşağıda STDIO sahte nesnelerine örnekler verilmiştir.

stdout ile yanıt verme

Stdout yanıtıyla belirli bir metin içeren stdin'e yanıt verin.

Dosya: stdio-mocks.json

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.2.0/mockstdioresponseplugin.schema.json",
  "mocks": [
    {
      "request": {
        "bodyFragment": "tools/list"
      },
      "response": {
        "stdout": "{\"jsonrpc\":\"2.0\",\"id\":1,\"result\":{\"tools\":[]}}\n"
      }
    }
  ]
}

stderr ile yanıt verme

stderr'da bir hata iletisiyle stdin'e yanıt verin.

Dosya: stdio-mocks.json

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.2.0/mockstdioresponseplugin.schema.json",
  "mocks": [
    {
      "request": {
        "bodyFragment": "invalid_method"
      },
      "response": {
        "stderr": "Error: Unknown method\n"
      }
    }
  ]
}

stdin'den yer tutucuları kullanma

Yanıta stdin değerlerini dinamik olarak eklemek için yer tutucuları kullanın @stdin.body.* .

Dosya: stdio-mocks.json

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.2.0/mockstdioresponseplugin.schema.json",
  "mocks": [
    {
      "request": {
        "bodyFragment": "tools/list"
      },
      "response": {
        "stdout": "{\"jsonrpc\":\"2.0\",\"id\":@stdin.body.id,\"result\":{\"tools\":[]}}\n"
      }
    }
  ]
}

Aşağıdaki yer tutucular kullanılabilir:

Placeholder	Description
@stdin.body.id	İstek kimliğini JSON-RPC
@stdin.body.method	JSON-RPC yöntem adı
@stdin.body.params.name	İç içe özellik erişimi

Dosyadan yanıt yükleme

Söz dizimini kullanarak @filename bir dış dosyadan sahte yanıt içeriğini yükleyin.

Dosya: stdio-mocks.json

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.2.0/mockstdioresponseplugin.schema.json",
  "mocks": [
    {
      "request": {
        "bodyFragment": "initialize"
      },
      "response": {
        "stdout": "@initialize-response.json"
      }
    }
  ]
}

Dosya: initialize-response.json

{"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2024-11-05","capabilities":{"tools":{}},"serverInfo":{"name":"Mock MCP Server","version":"1.0.0"}}}

Normal ifade kullanarak isteği eşleştirme

Normal ifade kullanarak stdin eşleştirmek için kullanın bodyRegex . Bu, alt dize eşleştirme ile bodyFragment belirsizliği önlemek için kesin eşleştirmeye ihtiyacınız olduğunda kullanışlıdır.

Dosya: stdio-mocks.json

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.2.0/mockstdioresponseplugin.schema.json",
  "mocks": [
    {
      "request": {
        "bodyRegex": "\"method\":\"tools/list\""
      },
      "response": {
        "stdout": "{\"jsonrpc\":\"2.0\",\"id\":1,\"result\":{\"tools\":[]}}\n"
      }
    }
  ]
}

N. oluşumda yanıtla

Yalnızca n. kez eşleşen stdin'i kestikten sonra yanıt verin.

Dosya: stdio-mocks.json

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.2.0/mockstdioresponseplugin.schema.json",
  "mocks": [
    {
      "request": {
        "bodyFragment": "tools/call",
        "nth": 2
      },
      "response": {
        "stdout": "{\"jsonrpc\":\"2.0\",\"id\":@stdin.body.id,\"result\":{\"content\":[{\"type\":\"text\",\"text\":\"Operation completed\"}]}}\n"
      }
    }
  ]
}

Sahte dosya özellikleri

Mülkiyet	Description	Gerekli
request	Eşleşecek stdin'i tanımlayan request nesnesi	yes
response	Döndürülecek yanıtı tanımlayan yanıt nesnesi	yes

İstek nesnesi

Her istek aşağıdaki özelliklere sahiptir:

Mülkiyet	Description	Gerekli	Varsayılan değer	Örnek değer
bodyFragment	stdin içinde mevcut olması gereken bir dize	no		tools/list
bodyRegex	Stdin ile eşleşecek normal ifade. Her ikisi de belirtildiğinde öncelikli bodyFragment olur.	no		^tools/
nth	Yalnızca isteğin n. kez araya girilmesiyle yanıt verme	no		2

Uyarı

bir bodyFragment istekle eşleşmesi için veya bodyRegex gereklidir. Her ikisi de belirtildiğinde öncelik bodyRegex kazanır.

Yanıt nesnesi

Her yanıt aşağıdaki özelliklere sahiptir:

Mülkiyet	Description	Gerekli	Varsayılan değer	Örnek değer
stdout	stdout'a gönderilecek içerik	no	boş	{"result": "ok"}\n
stderr	Stderr'a gönderilecek içerik	no	boş	Error: Something went wrong\n

Yanıt açıklamaları

Bir dosyadan yanıt içeriği yüklemek istiyorsanız, or stdout özelliğini sahte dosyaya göre dosya yolu ile stderr başlayan bir dize değeri olarak ayarlayın@. Örneğin, @response.json sahte dosyayla response.json aynı dizindeki dosyada depolanan içeriği döndürür.

Stdin değerlerini yanıta dinamik olarak eklemek için yer tutucuları kullanın @stdin.body.* . Örneğin, @stdin.body.id stdin JSON'dan özelliğinin değerini id döndürür.

Eklenti açıklamaları

Bu eklenti, yerel yürütülebilir dosyalarla STDIO iletişimini kesmek ve taklit etmek için komutuyla kullanılmak üzere tasarlanmıştır.stdio Model Bağlam Protokolü (MCP) sunucularını ve diğer STDIO tabanlı uygulamaları test edip hata ayıklamak için kullanışlıdır.

blockUnmockedRequests olarak ayarlandığındatrue, sahte ile eşleşmeyen tüm stdinler kullanılır ve alt işleme iletilmez. Gerçek mantığını çalıştırmadan yürütülebilir dosyanın davranışıyla tam olarak alay etmek istediğinizde, kırpılmamış isteklerin engellenmesi yararlıdır.

Sonraki adım

MCP sunucuları için sahte STDIO yanıtları