tsb-kasko-mcp
tsb-kasko-mcp — TSB Kasko Değer Listesi için MCP sunucusu ve CLI
Türkiye Sigorta Birliği'nin (TSB) yayımladığı Kasko Değer Listesi'ni sorgulayan
açık kaynak MCP sunucusu, komut satırı aracı ve Python istemcisi.
Claude, ChatGPT, Gemini ve Cursor içinden "2025 model Audi A3'ün kasko bedeli ne
kadar" diye sorabilir; terminalden tsb-kasko lookup 2025 "audi a3" yazabilir ya
da kendi Python projenizde kütüphane olarak kullanabilirsiniz.
Kasko değer listesi, Türkiye'de satılan her kasko poliçesinin fiyatlandığı referans bedeldir. Aynı zamanda pert (tam hasar) ve çalınma durumlarında ödenecek tutarın da dayanağıdır. Bu proje, TSB'nin web sitesinin arka planında kullandığı ve kimlik doğrulaması gerektirmeyen uçları tiplenmiş bir istemciye dönüştürür.
Arayüz | Nasıl çalıştırılır | Kime göre |
MCP sunucusu |
| Claude, ChatGPT, Gemini, Cursor |
Komut satırı |
| Terminal, betik, CI |
Python istemcisi |
| Kendi uygulamanız |
Paket kurulduğunda iki komut birden gelir; ayrı bir CLI paketi kurmanıza gerek yoktur.
İçindekiler
Related MCP server: DPVAT: Emissão de Guia
Ne işe yarar
Yapay zekâ asistanından kasko bedeli sorgulama. Claude, ChatGPT ve Gemini içinden doğal dille sorarsınız, model aracı çağırır, güncel bedeli döner.
Terminalden sorgulama.
tsb-kasko lookup 2025 "audi a3 sportback"komutu tabloyu, JSON'u veya CSV'yi doğrudan basar.Poliçedeki araç kodu. Sonuçlar sigortacının sorduğu
marka kodu - model koduikilisini de içerir, örneğin9-1616.Geçmiş listeler. TSB her ay listeyi yeniden yayımlar. Geçmiş ayların Excel dosyasını indirebilir veya içinde arama yapabilirsiniz.
Python kütüphanesi. Kendi projenizde
TsbKaskoClientsınıfını doğrudan kullanabilirsiniz.
Kurulum
Ön koşul: uv. Python'u da o kurar.
Kurulum yapmadan denemek için:
uvx --from git+https://github.com/hmtkyn/tsb-kasko-mcp tsb-kasko lookup 2025 "audi a3 sportback"Kalıcı kurulum:
uv tool install git+https://github.com/hmtkyn/tsb-kasko-mcpveya pip ile:
pip install git+https://github.com/hmtkyn/tsb-kasko-mcpPaket henüz PyPI'de yayımlanmadı. Yayımlandığında
uv tool install tsb-kasko-mcpvepip install tsb-kasko-mcpde çalışacak; yayımlama iş akışı depoda hazır.
Depodan geliştirme kurulumu için Geliştirme bölümüne bakın.
MCP kurulumu
Sunucu hem stdio hem de streamable HTTP taşımasını destekler, bu yüzden hem
masaüstü istemcileri hem de barındırılan bağlayıcılar için çalışır.
Claude Code
claude mcp add tsb-kasko -- uvx --from git+https://github.com/hmtkyn/tsb-kasko-mcp tsb-kasko-mcpClaude Desktop
claude_desktop_config.json dosyasına ekleyin:
{
"mcpServers": {
"tsb-kasko": {
"command": "uvx",
"args": ["--from", "git+https://github.com/hmtkyn/tsb-kasko-mcp", "tsb-kasko-mcp"]
}
}
}Cursor / VS Code
.cursor/mcp.json veya çalışma alanındaki .vscode/mcp.json dosyasına aynı
mcpServers bloğunu ekleyin.
Gemini CLI
~/.gemini/settings.json dosyasına ekleyin:
{
"mcpServers": {
"tsb-kasko": {
"command": "uvx",
"args": ["--from", "git+https://github.com/hmtkyn/tsb-kasko-mcp", "tsb-kasko-mcp"]
}
}
}ChatGPT ve diğer uzak istemciler
ChatGPT bağlayıcıları sunucuya HTTP üzerinden ulaşır. Sunucuyu HTTP modunda çalıştırın:
TSB_KASKO_TRANSPORT=http TSB_KASKO_HOST=0.0.0.0 TSB_KASKO_PORT=8000 tsb-kasko-mcpveya herhangi bir ASGI sunucusuyla:
uvicorn tsb_kasko.asgi:app --host 0.0.0.0 --port 8000Uç nokta varsayılan olarak http://sunucu:8000/mcp adresinde yayınlanır. En
kolay yol için Docker bölümüne bakın.
MCP araçları
Araç | Ne yapar |
| Serbest metinden araç bulur ve her eşleşmenin kasko bedelini döner. Ana araç budur. |
| Listenin kapsadığı model yıllarını döner. Kapsam 2012 ve sonrasıdır. |
| Bir model yılındaki markaları listeler. |
| Bir markanın o model yılındaki tiplerini listeler. |
| Model kimliği bilinen tek bir aracın bedelini okur. |
| Belirli bir ayın yayımlanmış Excel dosyasını çözümler. |
| Geçmiş bir ayın listesi içinde arama yapar. |
| Belirli bir ayın Excel dosyasını diske indirir. |
kasko_download_archive dışındaki tüm araçlar readOnlyHint ile işaretlidir;
yani istemci onlar için onay istemeden çağrı yapabilir.
Komut satırı kullanımı
# Kapsanan model yılları
tsb-kasko years
# Bir model yılındaki markalar
tsb-kasko brands 2025
# Bir markanın tipleri
tsb-kasko models 2025 audi
# Serbest metinle sorgulama
tsb-kasko lookup 2025 "audi a3 sportback s line"
# Markayı sabitleyerek hızlandırma
tsb-kasko lookup 2025 "corolla hybrid" --brand toyota --limit 10
# JSON veya CSV çıktısı
tsb-kasko lookup 2025 "audi a3" --format json
tsb-kasko brands 2025 --format csv > markalar.csv
# Arşiv
tsb-kasko archive months
tsb-kasko archive file 2025 2
tsb-kasko archive search 2025 2 --query "sahin" --limit 20
tsb-kasko archive download 2025 2 --output ~/Downloads
# Önbellek
tsb-kasko cache path
tsb-kasko cache clear
# MCP sunucusunu CLI üzerinden çalıştırma
tsb-kasko serve --transport http --port 8000Örnek çıktı:
audi a3 sportback in 2025
┏━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┓
┃ Vehicle Code ┃ Brand ┃ Model ┃ Kasko Value ┃
┡━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━┩
│ 9-1616 │ AUDI │ A3 SPORTBACK 35 TFSI 150 S LINE ... │ 3.695.439,00 TL│
└──────────────┴───────┴─────────────────────────────────────┴────────────────┘Python kütüphanesi olarak
import asyncio
from tsb_kasko import TsbKaskoClient
async def main() -> None:
async with TsbKaskoClient() as client:
for value in await client.lookup(2025, "audi a3 sportback"):
print(value.vehicle_code, value.model_name, value.amount)
asyncio.run(main())Docker
Konteyner, MCP sunucusunu HTTP taşımasıyla yayımlar. İki aşamalı derleme kullanır, kök olmayan bir kullanıcıyla çalışır ve dosya sistemi salt okunurdur.
docker compose up --build
# -> http://127.0.0.1:8000/mcpYalnızca imajı derleyip CLI'yi çalıştırmak için:
docker build -f .docker/python/Dockerfile -t tsb-kasko-mcp .
docker run --rm --entrypoint tsb-kasko tsb-kasko-mcp lookup 2025 "audi a3"Python sürümü imaja ARG PYTHON_VERSION ile sabitlenmiştir ve depodaki
.python-version ile aynı sürümü kullanır.
Yapılandırma
Tüm ayarlar ortam değişkenleriyle geçersiz kılınabilir.
Değişken | Varsayılan | Açıklama |
|
| TSB uygulamasının kök adresi. |
|
| İstek başına zaman aşımı, saniye. |
|
| Geçici hatalarda deneme sayısı. |
|
|
|
|
| Marka ve model listelerinin önbellek ömrü, saniye. |
|
| Önbellek dizini. |
|
| MCP taşıması: |
|
| HTTP taşımasının dinleme adresi. |
|
| HTTP taşımasının portu. |
|
| ASGI uygulamasındaki uç nokta yolu. |
Kullanılan TSB uçları
TSB bir API sözleşmesi yayımlamıyor. Aşağıdaki uçlar sitenin ön yüzünün
kullandığı, kimlik doğrulaması ve çerez gerektirmeyen uçlardır. Hepsi
src/tsb_kasko/endpoints.py içinde tek yerde
tanımlıdır.
Uç | Parametreler | Döner |
| yok | Kapsanan model yılları |
|
| Markalar |
|
| Tipler |
|
| Kasko bedeli ve araç kodu |
| yok | Arşiv ayları |
|
| Aylık Excel dosyasının yolu |
İki ayrıntı dikkat çekicidir:
Marka listesindeki
VehicleBrandCodealanı her zaman0gelir. Poliçede yazan gerçek marka kodu yalnızcaGetInsuranceDatasyanıtında dolu gelir.GetMonthListiçindekiIdalanı takvim ayı değildir. Ocak2, Ekim ise1kimliğine sahiptir. Bu yüzden istemci ay kimliğini hesaplamaz, canlı listeden çözer.
Proje yapısı
Üç arayüz de aynı çekirdeğin üstünde duran ince kabuklardır. Bu yüzden hepsi tek repoda yaşar: TSB bir ucu yeniden adlandırdığında düzeltme tek dosyada yapılır, üç ayrı sürüm senkronu gerekmez.
src/tsb_kasko/
├── client.py # çekirdek: HTTP, yeniden deneme, önbellek
├── endpoints.py # TSB uçlarının tek tanım yeri
├── models.py # Pydantic modelleri
├── parsing.py # zarf açma, Türkçe sayı ve metin normalleştirme
├── archive.py # aylık Excel listelerinin okuyucusu
├── server.py # kabuk 1: FastMCP sunucusu
├── cli.py # kabuk 2: Typer komut satırı
└── asgi.py # HTTP taşıması için ASGI uygulamasıAynı düzen github/github-mcp-server, microsoft/playwright-mcp ve
grafana/mcp-grafana projelerinde de kullanılıyor: ortak çekirdek, üstünde
birden fazla giriş noktası.
Geliştirme
git clone https://github.com/hmtkyn/tsb-kasko-mcp.git
cd tsb-kasko-mcp
uv sync --all-extras --all-groups
uv run pre-commit installuv run pytest # 146 test, kayıtlı gerçek yanıtlarla
uv run pytest --cov --cov-report=term-missing # kapsam raporu
uv run ruff check . # lint
uv run ruff format . # biçimlendirme
uv run mypy src/tsb_kasko # strict tip denetimi
uv run pre-commit run --all-files # CI'ın yaptığının tamamıTestler TSB'den alınmış gerçek yanıtların birebir kopyalarını kullanır, bu sayede sözleşme değiştiğinde testler kırılır. Ağa çıkan test yoktur.
Windows, macOS ve Linux'ta aynı sonuç
Bu depo üç işletim sisteminde de aynı davranacak şekilde ayarlandı:
.python-versionPython sürümünü 3.14'e sabitler;uvgerekirse indirir. Paketin desteklediği aralık ise>=3.11ve CI dört sürümü birden test eder..gitattributesher metin dosyasını depoda LF ile saklar. Windows'tacore.autocrlfaçık olsa bile depoya CRLF girmez. CI'da bir adım bunu ayrıca denetler..editorconfiggirinti, kodlama ve satır sonunu editörden bağımsız sabitler..devcontainer/ile hiçbir şey kurmadan konteyner içinde geliştirebilirsiniz.
Ayrıntılar için CONTRIBUTING.md.
Sık sorulanlar
Kasko değeri nedir, neye göre belirlenir? TSB'nin her ay yayımladığı, marka ve tip bazında referans araç bedelidir. Sigorta şirketleri poliçe primini ve hasar ödemesini bu bedel üzerinden hesaplar.
Aracımın kasko bedelini nasıl öğrenirim?
tsb-kasko lookup <model_yılı> "<marka ve tip>" komutunu çalıştırın ya da MCP
sunucusunu kurup asistanınıza sorun. Resmî kaynak her zaman
tsb.org.tr adresidir.
Poliçedeki araç kodu nedir?
Sigortacının sorduğu marka kodu - model kodu ikilisidir, örneğin 9-1616.
Sonuçlarda vehicle_code alanında döner.
Hangi model yılları kapsanıyor?
2012 ve sonrası. Güncel listeyi tsb-kasko years ile görebilirsiniz.
Geçmiş bir ayın listesine ulaşabilir miyim?
Evet. tsb-kasko archive search 2025 2 --query "sahin" geçmiş ayın Excel
dosyasında arar, archive download ise dosyanın kendisini indirir.
Bu proje resmî mi? Hayır. Aşağıdaki sorumluluk reddine bakın.
Sorumluluk reddi
Bu proje TSB ile ilişkili değildir ve TSB tarafından desteklenmemektedir. Veriler TSB'nin herkese açık sayfasından alınır. TSB'nin kendi ifadesiyle, bu değerlerin işlemlerde kullanılmasından doğacak sonuçlardan TSB sorumluluk kabul etmemektedir. Resmî kaynak her zaman tsb.org.tr adresidir.
Uçlar TSB tarafından belgelenmediği için haber verilmeden değişebilir. Böyle bir
durumda src/tsb_kasko/endpoints.py dosyasını
güncellemek yeterlidir.
Katkı ve lisans
Katkı rehberi: CONTRIBUTING.md
Davranış kuralları: CODE_OF_CONDUCT.md
Güvenlik politikası: SECURITY.md
Değişiklik günlüğü: CHANGELOG.md
MIT lisansı ile yayımlanmıştır. 中文信息翻译:docs/lisans.md。
Available Tools
8 toolskasko_archive_fileARead-only
Resolve the monthly kasko list spreadsheet published by TSB.
TSB republishes the full list every month and keeps the past editions online. Use this to cite or hand the user the exact file for a given month, or to compare a current value against an older one.
Inputs: year (required), month (required). Returns: object
kasko_download_archiveA
Download a monthly kasko list spreadsheet to disk.
Use this when the user wants the whole list as a file rather than a few rows. Prefer kasko_search_archive when they only need specific vehicles.
Inputs: year (required), month (required), destination. Returns: object
kasko_get_valueARead-only
Read the kasko value of one exact model by its identifier.
Use this after the user picks a specific row from kasko_list_models. When the vehicle is only described in words, use kasko_lookup instead.
Inputs: model_id (required), model_year (required). Returns: object
kasko_list_brandsARead-only
List the vehicle brands available for a model year.
Brand availability differs per model year, so the year is required. The returned brand_id is the identifier kasko_list_models expects; it is not the brand code printed on policies.
Inputs: model_year (required). Returns: object
kasko_list_modelsARead-only
List the models of one brand in a model year.
Model names carry trim, engine and gearbox information, which is what makes two rows of the same nameplate differ in value. The returned model_id is the identifier kasko_get_value expects.
Inputs: brand (required), model_year (required). Returns: object
kasko_list_model_yearsARead-only
List the vehicle model years covered by the TSB kasko value list.
Call this when the user gives no model year, or to check whether a year is covered before querying it. Coverage starts at 2012.
Returns: A mapping with the covered model years in descending order.
Inputs: no named parameters. Returns: object
kasko_lookupARead-only
Look up the kasko value of a vehicle from a free text description.
This is the primary tool. It resolves the description to matching models and returns the value of each, so no identifier lookup is needed first. Every result carries vehicle_code, the brand and model code pair printed on policies, which is the value an insurer will ask for.
When several trims match, present them to the user rather than guessing: the spread between trims of the same nameplate is often large.
Inputs: query (required), model_year (required), brand, limit. Returns: object
kasko_search_archiveARead-only
Search inside a past monthly kasko list.
Answers historical questions the live endpoints cannot, such as what a vehicle was valued at earlier in the year. The spreadsheet is downloaded and filtered server side, so keep the query specific.
Inputs: year (required), month (required), limit, query. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a distinct purpose: browsing hierarchy (years, brands, models), direct value lookup (free-text vs exact ID), and archive handling (resolve, search, download). No two tools overlap enough to cause confusion, and the descriptions clearly differentiate kasko_lookup from kasko_get_value.
Most tools follow the kasko_<verb>_<object> pattern (list_brands, get_value, search_archive). Minor deviations: kasko_lookup lacks an object, and kasko_archive_file is noun-like rather than verb-led. Overall the convention is consistent and readable.
With 8 tools, the set is well-scoped for a kasko lookup service. Three tools cover hierarchical browsing, two cover value retrieval, and three cover archive operations. No tool feels redundant or missing.
The surface covers the full user journey: discover coverage years, browse brands/models, get current value by text or exact ID, and access historical data via archive tools. No critical operations are missing for a read-only reference service.
Maintenance
Related MCP Connectors
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Real, bindable home & auto insurance quotes via MCP — actual carrier rates, not estimates. Texas today, expanding across the US. AI agents can check eligibility, run a live multi-carrier quote, compare options (carrier names hidden until bind), and hand the customer a secure link where a licensed agent finalizes coverage — never an automated purchase. No sign-up or API key required; optional free partner keys for integrators.
SmartMoney77 MCP v0.6.0 — 14 public tools that turn financial questions into exact numbers and citable links. New: historical_investment_return and compare_investments, which compute "what if I had invested" results from real yearly price data. Also compound interest, FIRE number, credit-card payoff, emergency fund, inflation, latte factor, investment fees, cost of waiting, plus discovery/deep-link/share-pack tools for a catalog of calculators in 6 languages (he/en/ar/es/pt/in). Public, no login. Endpoint: https://smartmoney77.com/mcp
Unofficial CarsXE MCP — wraps the CarsXE Vehicle Data API (carsxe.com)
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server that unifies official Turkish open data sources into a single interface, letting AI agents query and compare normalized indicators like population, inflation, and GDP through natural language.10MIT
- AlicenseNot gradedqualityDmaintenanceRead-only MCP server for querying DPVAT (Brazilian insurance) guide issuance information from an official source. It provides a single tool that allows users to consult DPVAT guide data via natural language in any MCP-compatible client.MIT
- AlicenseAqualityBmaintenanceEnables product search, store price comparison, basket comparison, and price history review using Market Fiyatı data through a stdio MCP server.15299 npmMIT
- AlicenseAqualityBmaintenanceEnables AI agents and MCP clients to compare Iranian insurers, ratings, and live prices for travel, third-party, car body, motorcycle, fire, and supplementary health insurance across BimeBazar and Azki, with Persian-aware, read-only access and no API key.1897 PyPI1PolyForm Noncommercial 1.0.0