# diaskor-mcp — Diyaliz Stabilite Skoru (DSS)

Hemodiyaliz hastasında "bu hasta kötüleşiyor mu?" sorusuna sahadan bakan, 28 puanlık bir klinik karar destek skoru. Claude Desktop gibi MCP destekleyen araçlarda doğrudan kullanılabilen bir MCP sunucusu olarak paketlendi.

> ⚠️ Bu bir klinik karar destek aracıdır, hekim kararının yerini almaz. Skor henüz prospektif olarak valide edilmemiştir. **Geliştirmeye ve tartışmaya açıktır.**

## Neden?

Diyaliz hastası aynı anda üç kanaldan kötüleşebilir: diyaliz yeterliliği, metabolik yük ve kronik zemin. Tek tek laboratuvar değerleri normal görünürken hasta "gidiyor" olabilir. DSS bu sinyalleri tek bir sayıda toplar. Bunu yaparken tek bir öldürücü değerin toplam içinde kaybolmasına da izin vermez.

## Nasıl çalışır?

Glasgow Koma Skalası mantığı: **toplamalı, tavanlı, yüksek puan = iyi.**

| Parametre | Puan |
|---|---|
| URR | 0–2 |
| Volüm (kişisel sodyum sapması + kuru ağırlık trendi) | 0–2 |
| Prediyaliz potasyum | 0–2 |
| Albumin | 0–4 |
| Hemoglobin (MCV / EPO bağlamıyla) | 0–2 |
| CRP (kişisel baseline'a göre) | 0–2 |
| Demir (TSAT + ferritin) | 0–2 |
| Mineral-kemik (Ca×P + PTH) | 0–2 |
| Bikarbonat | 0–2 |
| Primer tanı + kontrol durumu (HbA1c, komplikasyon) | 0–4 |
| Kırılganlık (Clinical Frailty Scale; yoksa biyolojik yaş) | 0–2 |
| Son 90 gün klinik olay | 0–2 |
| **Toplam** | **0–28** |

**Karar:** 19–28 stabil · 10–18 yakından izle · <10 acil değerlendir

**Kırmızı bayrak:** K ≥ 6.5 veya albumin < 2.5 olduğunda toplam puan kaç olursa olsun alarm verir.

**Trend:** 3 aylık gidiş kötüyse yeşil parametre sarıya iner ve "↓ kötüleşiyor" etiketi alır.

**Bağlam mesajları:** Skor sadece sayı vermez, hekime bir cümle de yazar. Örnekler: "Hb düşük + MCV < 80 → demir eksikliği", "Ca×P yüksek ama diyaliz yeterli → diyet ve bağlayıcıya bakın", "CRP 2 kat + ferritin ve lökosit yüksek → enfeksiyon olasılığı".

Tüm eşikler `src/skor.js` içindeki `ESIK` nesnesinde tek bir yerde durur.

## Gizlilik

Araç **hiçbir veri saklamaz**, ağ bağlantısı kurmaz, isim ya da kimlik numarası istemez. Değerleri alır, puanı hesaplar, sonucu döndürür.

## Kurulum (Claude Desktop)

```bash
git clone https://github.com/turgutkecik/diaskor-mcp.git
cd diaskor-mcp
npm install
npm test
```

`claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "diaskor": {
      "command": "node",
      "args": ["C:/yol/diaskor-mcp/src/index.js"]
    }
  }
}
```

## Araçlar

- `dss_hesapla`: skoru hesaplar; parametre puanlarını, renkleri, trendleri, kırmızı bayrakları ve bağlam mesajlarını döner.
- `dss_yontem`: tüm eşikleri ve karar aralıklarını döner.

Kod içinden de kullanılabilir:

```js
import { hesapla } from 'diaskor-mcp';
const sonuc = hesapla({ yas: 62, diyaliz_suresi_yil: 6, primer_tani: 'dm', hba1c: 6.8, lab: { urr: 67, k: 5.2, albumin: 3.3 } });
```

## Teşekkür

[Nexgene Research](https://github.com/Nexgene-Research/nexonco-mcp) ekibinin Nexonco MCP çalışmasından ilham alındı.

## Yazar

Dr. A. Turgut Keçik — hemodiyaliz hekimi (2008'den beri). Arca (Claude) ile birlikte geliştirildi.

## Lisans

[PolyForm Noncommercial 1.0.0](LICENSE). Hekimler, araştırmacılar, akademik kurumlar ve kar amacı gütmeyen kuruluşlar aracı serbestçe kullanabilir, değiştirebilir ve paylaşabilir. **Ticari kullanım** için (yazılım firmaları, ücretli ürün ya da hizmet içine yerleştirme gibi) önce izin alınması gerekir: [diasera.com.tr/iletisim](https://diasera.com.tr/iletisim)

---

*English summary: DSS is a 28-point, additive, GCS-style stability score for hemodialysis patients (higher = better), exposed as an MCP server. It combines dialysis adequacy, metabolic/inflammatory burden, chronic background and frailty. Red flags (K ≥ 6.5, albumin < 2.5) override the total score. It stores no data. Clinical decision support only; not yet validated. Open to discussion and contributions. Licensed under PolyForm Noncommercial 1.0.0; commercial use requires permission.*