Sampuli
Format-true synthetic test data for 90 countries — IBANs, SWIFT/BIC, IDs, cards, all certified.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"sampuli": {
"command": "npx",
"args": [
"@sampuli/mcp"
]
}
}
}실행 가능한 패키지
0.1.2stdio원격 엔드포인트
https://sampuli.site/api/mcpstreamable-http할 수 있는 일
도구 목록
도구 (6)
🟢sampuli_list_countries
List every country Sampuli can generate synthetic test data for (90 countries), with the ISO code used as a spec prefix.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢sampuli_describe_country(country)
List a country's available fields (phone, national ID, tax number, IBAN, SWIFT/BIC, card, …) and preset scenarios.
입력 스키마
{
"type": "object",
"properties": {
"country": {
"type": "string",
"description": "ISO code, e.g. \"ke\", \"de\", \"us\", \"ng\"."
}
},
"required": [
"country"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪sampuli_generate(spec, count, fields, seed, format)
Generate format-true, entirely synthetic test data for a country. spec is "<country>.<selector>" where selector is a field key ("phone"), "person" (a full coherent record), or "preset:<key>" (a scenario). Values match each country's real formats and pass validators (IBAN mod-97, card Luhn, …) but are never real or registered.
입력 스키마
{
"type": "object",
"properties": {
"spec": {
"type": "string",
"description": "e.g. \"ke.person\" (core fields), \"ke.full\" (every field incl. card/passport/income), \"de.iban\", \"ng.phone\", \"ke.company\", \"ke.product\", \"ke.preset:kyc\"."
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"description": "How many rows (omit for one)."
},
"fields": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string",
"const": "all"
}
],
"description": "Which fields for a person record, or \"all\"."
},
"seed": {
"type": "string",
"description": "Reproducible output — same seed, same data."
},
"format": {
"type": "string",
"enum": [
"json",
"csv"
],
"description": "Output format (default json)."
}
},
"required": [
"spec"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢sampuli_fetch(query, count, format, seed)
Fetch synthetic test data from a natural request when you don't know the exact spec — e.g. "a SWIFT code for China", "Kenya phone number", "German passport", "a Nigerian BVN". Sampuli resolves the country and field for you (China→cn, "SWIFT code"→swift) and generates a format-true value. Prefer sampuli_generate when you already have a spec like "cn.swift".
입력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Plain-language request, e.g. \"a SWIFT code for China\", \"UK IBAN\", \"India GSTIN\"."
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"description": "How many (omit for one)."
},
"format": {
"type": "string",
"enum": [
"json",
"csv"
],
"description": "Output format (default json)."
},
"seed": {
"type": "string",
"description": "Reproducible output."
}
},
"required": [
"query"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢sampuli_list_types
List the country-agnostic generic types (uuid, enum, int, float, date, vin, isbn, imei, mac, email, …) usable in a custom schema or as "any.<type>".
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪sampuli_schema(fields, count, seed, format)
Generate rows from a custom schema, mixing generic types and country-accurate fields. Each field has a name and a type — a generic type ("uuid", "int:0,500", "enum:free,pro,team", "date:2021,2025") or a country field spec ("ke.phone", "de.iban"). Optional per-field "blank" (0–1) makes it null that often.
입력 스키마
{
"type": "object",
"properties": {
"fields": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Column name."
},
"type": {
"type": "string",
"description": "Generic type or country field spec, e.g. \"uuid\", \"int:0,500\", \"ke.phone\"."
},
"blank": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Probability (0–1) the value is null."
}
},
"required": [
"name",
"type"
],
"additionalProperties": false
},
"description": "The columns to generate."
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"description": "How many rows (default 1)."
},
"seed": {
"type": "string",
"description": "Reproducible output."
},
"format": {
"type": "string",
"enum": [
"json",
"csv"
]
}
},
"required": [
"fields"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}커뮤니티
증거