service-test-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@service-test-mcp call GetUser with id 42 and assert the SOAP response status is 200"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
service-test-mcp-simple (service-test-mcp)
WCF/SOAP ve REST servislerini test etmek için MCP sunucusu. VS Code'da GitHub Copilot (Agent modu, custom agent'lar) ile ya da VS Code'dan bağımsız herhangi bir MCP istemcisi / AI ajanıyla kullanılır. sql-mcp-simple ve mongo-mcp-simple ile aynı yaklaşım: ajan servis çağrılarını PowerShell / Invoke-WebRequest / curl çalıştırmadan, doğrudan bu sunucunun araçlarıyla yapar.
SOAP / WCF | WSDL keşfi, operasyon şeması ve örnek parametre, çağrı, SOAP fault (code/message/detail), ham zarf (isteğe bağlı). SOAP 1.1/1.2, |
REST | Tüm HTTP metotları, JSON/metin/form gövde, OpenAPI/Swagger keşfi |
Kimlik doğrulama | Windows oturumu (Kerberos/NTLM, şifresiz), NTLM, basic, bearer, API key, WS-Security UsernameToken, istemci sertifikası |
Senaryolar | YAML; SOAP ve REST adımları aynı dosyada, |
Assertion'lar | Sunucu içinde, deterministik: |
Güvenlik | Host allowlist (WSDL import'ları ve yönlendirmeler dahil), prod ortam adları reddedilir, mutating operasyon engeli, maskeleme (TCKN checksum, IBAN, kart Luhn, telefon, e-posta, şifre/token alanları), JSONL denetim logu, şifreler hiçbir çıktıda görünmez |
Bağımsız kullanım |
|
Kurulum | Offline: Windows x64 ve x86 (32-bit) için Python 3.10–3.14 tekerlekleri zip içinde |
Neden EDR / DLP ajanlarını daha az tetikler?
Her servis çağrısında powershell.exe açılıp Invoke-WebRequest ile elle birleştirilmiş SOAP zarfları göndermek, script-block logging, AMSI ve EDR kurallarının tam olarak izlediği davranıştır. service-test-mcp ise VS Code'un bir kez başlattığı tek bir Python sürecidir; çağrı başına alt süreç açmaz, komut satırında URL, gövde veya şifre bulunmaz, bağlantılar yeniden kullanılır.
Dürüst not: Hiçbir araç, kurumunuzdaki güvenlik ürünlerinin hiçbir şey raporlamayacağını garanti edemez. Gerekirse BT ekibinizden yalnızca bu
service-test-mcp.exeyolu için istisna isteyin; bu, "her çağrıda PowerShell" istisnasından çok daha dar ve savunulabilir bir istisnadır.
Related MCP server: api-test-mcp
Kurulum (Windows, internet gerekmez)
Python'unuza uygun paketi indirip bir klasöre açın:
64-bit Python: service-test-mcp-simple-windows-x64.zip
32-bit Python: service-test-mcp-simple-windows-x86.zip
Python'unuzun kaç bit olduğunu
py -c "import struct; print(struct.calcsize('P')*8)"gösterir.Klasörü VS Code'da açın, Copilot Chat → Agent moduna şunu yazın:
KURULUM_REHBERI.md dosyasını oku ve "Ajan için kurulum adımları" bölümünü sırayla uygula.
Elle kurulum: zip klasöründe install.cmd çalıştırın → %USERPROFILE%\.service-test-mcp\Scripts\service-test-mcp.exe.
İnternet varsa:
py -m venv %USERPROFILE%\.service-test-mcp
%USERPROFILE%\.service-test-mcp\Scripts\pip install --prefer-binary "service-test-mcp-simple @ git+https://github.com/ohankay/service-test-mcp-simple.git"Hemen denemek için: demo servisler
Zip içindeki demo klasöründe WCF tarzı bir SOAP servisi ve bir REST API'ye karşı hazır services.yaml ve 3 senaryo var:
%USERPROFILE%\.service-test-mcp\Scripts\service-test-mcp.exe --demo-server
rem baska bir terminalde:
set STM_CONFIG=C:\Araclar\service-test-mcp-simple\demo\services.yaml
%USERPROFILE%\.service-test-mcp\Scripts\service-test-mcp.exe --run C:\Araclar\service-test-mcp-simple\demo\scenariosVS Code'a ekleme
Ctrl+Shift+P → MCP: Open User Configuration:
{
"inputs": [
{ "type": "promptString", "id": "stm-pw-ntlm", "description": "Servis kullanicisi sifresi", "password": true }
],
"servers": {
"service-test": {
"type": "stdio",
"command": "${userHome}\\.service-test-mcp\\Scripts\\service-test-mcp.exe",
"env": {
"STM_CONFIG": "${userHome}\\.service-test-mcp\\services.yaml",
"STM_PW_NTLM": "${input:stm-pw-ntlm}"
}
}
}
}Şifreyi VS Code bir kez sorar ve güvenli deposunda saklar. Hiçbir dosyaya düz metin olarak yazılmaz. Custom agent için .github/agents/service-tester.agent.md (tools: ['service-test/*', ...]), terminale kaçmayı önlemek için templates/copilot-instructions.md, hazır görevler için .github/prompts/ kullanılabilir.
Servis kataloğu (services.yaml)
default_environment: test
environments:
test:
verify_tls: true # veya kurum CA dosyası: C:\certs\kurum-ca.pem
allow_mutating: false
variables: { test_musteri_no: "1234567" } # senaryoda {{env.test_musteri_no}}
services:
HesapServisi:
protocol: soap
wsdl: { test: https://sunucu-test/HesapServisi.svc?wsdl }
auth: { type: windows } # şifresiz, oturum açmış Windows kullanıcısı
mutating_operations: [TransferYap, "*Sil"]
OdemeApi:
protocol: rest
base_url: { test: https://api-test.sirket.local/odeme/v1 }
openapi: { test: https://api-test.sirket.local/odeme/v1/swagger.json }
auth: { type: bearer, token_env: STM_TOKEN_API }Tüm seçenekler: bundle/templates/services.yaml. Bir servis hatalı tanımlıysa yalnızca o servis "broken" görünür, diğerleri çalışır. prod, production, prd, canli, live adlı ortamlar reddedilir. İstekler yalnızca o servisin o ortam için yapılandırılmış host'larına gidebilir; WSDL farklı bir adres yayınlıyorsa (endpoint veya allowed_hosts ile) açıkça izin verilmelidir.
Araçlar
Araç | Ne yapar |
| Servisler, ortamlar, varsayılan ortam, hatalı tanımlar |
| SOAP: port/binding, adres, operasyonlar. REST: base URL, OpenAPI operasyonları |
| Girdi/çıktı şeması, |
| Operasyon çağırmadan bağlantı testi (WSDL yükleme / base URL) |
| SOAP operasyonu çağırır; |
| REST çağrısı; |
|
|
| Son çağrının yanıtına assertion'ları uygular |
| Senaryo dosyası/klasörü/metni: yapı, servis adları, assertion sözdizimi, JSONPath, tanımsız değişkenler |
| Tek senaryo (dosya veya satır içi YAML) |
| Klasördeki tüm senaryolar, etiket filtresi, JUnit raporu |
|
|
Maskelenen değerler (***1326) modele geri yazdırılamaz; token ve id'ler extract ile saklanıp {{token}} olarak kullanılır. Assertion'lar ve extract her zaman gerçek değerlerle çalışır.
Senaryo formatı
id: login-bakiye
title: Login -> bakiye -> hesap detayı
tags: [smoke]
steps:
- name: Login
service: HesapServisi # SOAP: operation + params
operation: Login
params: { kullaniciAdi: "{{env.kullanici}}", sifre: "{{secret.STM_SECRET_TEST_SIFRE}}" }
assert:
- fault: none
- path: $.Token
notEmpty: true
extract: { token: $.Token, musteriNo: $.MusteriNo }
- name: Bakiye
service: HesapServisi
operation: GetBakiye
params: { token: "{{token}}", musteriNo: "{{musteriNo}}" }
assert:
- path: $.ToplamBakiyeTRY
numeric: { gte: 0 }
- path: $.Hesaplar.Hesap[*].Iban
matches: "^TR\\d{24}$"
all: true
- name: Hesap detayı
service: OdemeApi # REST: method + path (+ query, headers, body)
method: GET
path: /hesaplar/{{musteriNo}}
headers: { Authorization: "Bearer {{token}}" }
assert:
- status: 200
- schema: schemas/hesap.jsonAssertion referansı: fault: none | any | {code, message_contains}, status: 200 | [200, 201] | {gte: 200, lt: 300}, responseTimeMs: {lt: 2000}, header: Content-Type + contains, schema: dosya.json, ve path: <JSONPath> + bir operatör: equals, notEquals, equalsIgnoreCase, contains, notContains, startsWith, endsWith, matches, in, notIn, exists, notEmpty, isNull, type (string, number, integer, decimal, boolean, object, array, null, date, datetime), numeric (eq, ne, gt, gte, lt, lte, between, tolerance), count, length, schema. all: true her eşleşmeye uygular, message: hata metnine eklenir. Bir adım başarısız olursa sonraki adımlar atlanır (continue_on_failure: true hariç).
SOAP yanıtları JSON'a normalize edilir: namespace'ler düşer, maxOccurs > 1 elemanlar her zaman listedir, xsd:decimal Decimal olarak karşılaştırılır, tarihler ISO-8601 metindir.
VS Code'dan bağımsız kullanım
Hazır ajan (service-test-agent, ek paket gerekmez): OpenAI uyumlu herhangi bir chat-completions sunucusuna bağlanır, MCP sunucusunu kendisi başlatır.
set STM_AGENT_BASE_URL=http://qwen.sirket.local:8000/v1
set STM_AGENT_MODEL=qwen2.5-72b-instruct
set STM_CONFIG=%USERPROFILE%\.service-test-mcp\services.yaml
service-test-agent --check
service-test-agent --prompt "HesapServisi Login operasyonu icin pozitif ve negatif senaryo yaz ve kostur" --output rapor.md
service-test-agent &rem interaktif sohbetModel sunucusunda tool calling açık olmalı (vLLM + Qwen: --enable-auto-tool-choice --tool-call-parser hermes). Azure OpenAI için STM_AGENT_AZURE_API_VERSION, anahtar için STM_AGENT_API_KEY.
Kendi ajanınız / framework'ünüz: MCP sunucusunu stdio ile (service-test-mcp.exe) veya HTTP ile başlatın:
set STM_HTTP_TOKEN=uzun-rastgele-bir-deger
service-test-mcp --transport http --host 0.0.0.0 --port 8765Uç nokta http://sunucu:8765/mcp, istemci Authorization: Bearer <token> gönderir (yerel olmayan adreste token zorunludur). LangChain/LangGraph (langchain-mcp-adapters), Semantic Kernel, Claude Desktop ve diğer MCP istemcileri doğrudan bağlanır; allowlist, maskeleme, mutating engeli ve denetim logu her istemci için aynen geçerlidir.
AI'sız koşu (CI, zamanlanmış görev):
service-test-mcp --run D:\testler\senaryolar --env test --tags smoke --junit sonuc.xml --report sonuc.jsonÇıkış kodu: 0 hepsi geçti, 1 başarısız senaryo var, 2 yapılandırma/senaryo hatası.
Bilinmesi gerekenler
Desteklenmeyen WCF binding'leri:
netTcpBinding,netNamedPipeBindingve SecureConversation'lı mesaj güvenliği (wsHttpBindingvarsayılanı) Python'dan çağrılamaz. Test ortamında ek birbasicHttpBindingendpoint'i istemek en temiz yoldur. Birden çok port varsa SOAP 1.1 port'u tercih edilir;port_nameile seçilebilir.Maskeleme varsayılanları: TCKN (checksum ile), TR IBAN, kart numarası (Luhn ile), cep telefonu, e-posta ve şifre/token/secret/cvv/pin alanları. Müşteri ve hesap numaraları varsayılan olarak maskelenmez (test akışında gerekli);
masking.fieldsile eklenir,masking.unmask_fieldsile çıkarılır.Denetim logu:
%USERPROFILE%\.service-test-mcp\logs\audit-YYYYMMDD.jsonl; her çağrı için kullanıcı, servis, operasyon, ortam, durum, süre ve maskeli gövde.Çıktılar varsayılan olarak 20.000 karakterle sınırlıdır (
max_response_chars); büyük yanıtlarda assertion veyaextractkullanın.
Geliştirme
pip install -e ".[dev]"
pytest -v # demo servislere karşı birim, entegrasyon, stdio/HTTP e2e ve ajan testleri
pip install uv && python scripts/build_bundle.py # release/*.zip (x64 + x86, Python 3.10-3.14)PyPI'da 32-bit Python 3.14 için PyYAML tekerleği olmadığından vendor/ altında saf Python bir PyYAML tekerleği bulunur (PYYAML_FORCE_LIBYAML=0 pip wheel pyyaml==6.0.3); yalnızca ikili tekerlek olmayan hedefte kullanılır.
Lisans
MIT
Available Tools
12 toolscheck_last_responseARead-only
Evaluate assertions against the last soap_call / rest_call response (real values, deterministic). Use it to try assertions before writing them into a scenario file.
Inputs: assertions (required). Returns: result
check_serviceBRead-only
Connectivity check without calling an operation: SOAP loads the WSDL and binds the port; REST requests base_url. Without 'service' every service is checked.
Inputs: service, environment. Returns: result
describe_operationBRead-only
Input/output schema of an operation. SOAP: operation name -> input_schema, example_params, output_schema. REST: 'METHOD /path' or operationId from the OpenAPI document.
Inputs: service (required), operation (required), environment. Returns: result
describe_serviceCRead-only
SOAP: WSDL ports, selected address and operation names. REST: base_url and OpenAPI operations (if configured).
Inputs: service (required), environment. Returns: result
list_servicesBRead-only
List configured services (SOAP/REST), environments and the default environment. Start here.
Inputs: environment. Returns: result
reload_configARead-only
Re-read services.yaml after it was edited (no server restart needed).
Inputs: no named parameters. Returns: result
rest_callA
Call a REST endpoint. path is relative to the service base_url (e.g. /hesaplar/123). body = JSON value, body_text = raw text (XML, form). path, query, headers and body may use {{variables}} (e.g. headers {"Authorization": "Bearer {{token}}"}). extract = {name: JSONPath} saves session variables. Returns status, body (parsed JSON or text), elapsed_ms.
Inputs: path (required), method (required), service (required), body, +6 more. Returns: result
run_scenarioA
Run one scenario file (or inline YAML 'content'). Steps run in order; extract passes values to later steps. verbosity: summary | failures (default: details only for failed steps) | full.
Inputs: path, content, variables, verbosity, +1 more. Returns: result
run_test_suiteA
Run every scenario under a folder (recursively), optionally only those with one of 'tags'. Returns a summary and failed assertions; junit_path writes a JUnit XML report.
Inputs: path (required), tags, verbosity, junit_path, +1 more. Returns: result
session_variablesBRead-only
Show (masked) or clear the session variables saved by 'extract' on soap_call / rest_call.
Inputs: clear. Returns: result
soap_callA
Call a SOAP/WCF operation. params = JSON object of the operation's input elements (see describe_operation). Values may use {{variables}}. extract = {name: JSONPath} saves values from the response as session variables (e.g. {"token": "$.Token"}) so later calls can send {{token}} even though it is masked in the output. Returns status, fault (code/message/detail) or body (JSON), elapsed_ms. include_raw adds the SOAP envelopes.
Inputs: service (required), operation (required), params, extract, +2 more. Returns: result
validate_scenarioARead-only
Validate scenario YAML (a file, a folder, or inline 'content'): structure, services, assertion syntax, JSONPath, and variables used before they are defined. Does not call any service.
Inputs: path, content. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Most tools have clearly distinct roles: discovery (list_services), introspection (describe_service vs describe_operation differ by granularity), connectivity (check_service), and invocation split cleanly by protocol (soap_call vs rest_call). The main soft overlap is run_scenario vs run_test_suite (single file vs folder/tags) and check_last_response vs scenario assertions, but descriptions make the boundaries explicit enough to choose correctly.
The set is predominantly consistent snake_case verb_noun (list_services, describe_operation, check_service, validate_scenario, run_scenario, reload_config). Minor deviations exist: soap_call/rest_call use protocol-first ordering and session_variables is a noun-only name with no verb, but the pattern remains readable and predictable.
At 12 tools the server is well-scoped for an API/service testing surface, with each tool mapping to a distinct phase (discover, describe, check, call, validate, run, inspect, reload). Nothing feels redundant or missing at the count level.
The lifecycle is largely covered: discovery, schema introspection, connectivity checks, SOAP/REST invocation with variable extraction, assertion probing, scenario validation and execution (single and suite), plus config reload. Gaps are minor: no tool to list/discover available scenario files or suites, and no built-in scenario authoring/write operation, so agents must rely on external file access.
Maintenance
Related MCP Connectors
AI-callable tools for API mocking, testing, monitoring, security, and automation.
- octoperfDeprecatedio.github.OctoPerf
Drive OctoPerf load testing from any AI agent: import, edit, validate, run scenarios, read metrics.
Webhook, email, WebSocket and tunnel testing for AI agents: capture, wait, verify, replay.
Free AI test helpers: injection inputs, OWASP mapping, release plans, response and tool-call packs.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to inspect, test, validate, compare, and debug HTTP APIs through a structured toolkit, with features such as secret redaction, response contract validation, regression comparison, health checks, and incident investigation workflows.MIT
- AlicenseAqualityCmaintenanceEnables AI agents to call real API endpoints and verify responses against OpenAPI specs, supporting contract testing, auth presets, spec diffing, and health checks.854 npmMIT
- AlicenseBqualityBmaintenanceEnables AI agents to drive API testing from YAML definitions, executing and chaining requests without hand-written curl, while keeping credentials out of the conversation and responses token-cheap, plus a VANDER-based QA review of endpoints.21MIT

Bowire MCPofficial
AlicenseAqualityBmaintenanceLets an AI agent discover and call the APIs of a running service — gRPC, REST/OpenAPI, GraphQL, SignalR, MQTT, WebSocket and more — and record, replay, mock and assert on those calls. Calls only go to allowlisted URLs, and tools that change state ask for confirmation first.2812Apache 2.0