Content
# e-Nabız MCP Server
<div align="center">
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
[](https://modelcontextprotocol.io/)
**Açık kaynak Model Context Protocol (MCP) sunucusu - Türkiye e-Nabız sağlık sistemi entegrasyonu**
[English](#english) | [Türkçe](#turkish)
</div>
---
## <a name="turkish"></a>🇹🇷 Türkçe
### 📖 Genel Bakış
e-Nabız MCP Server, Türkiye Cumhuriyeti Sağlık Bakanlığı'nın e-Nabız (Ulusal Sağlık Sistemi) ile entegrasyon sağlayan açık kaynak bir Model Context Protocol (MCP) sunucusudur. Bu proje, Claude, ChatGPT ve diğer AI asistanlarının e-Nabız verileriyle güvenli bir şekilde etkileşime girmesini sağlar.
### ✨ Özellikler
- 🏥 **Hasta Bilgileri**: TC kimlik numarasıyla hasta bilgilerini sorgulama
- 📋 **Sağlık Kayıtları**: Tarih aralığına göre sağlık kayıtlarına erişim
- 💊 **Reçete Geçmişi**: Hasta reçete geçmişini görüntüleme
- 🔬 **Laboratuvar Sonuçları**: Tahlil ve test sonuçlarını sorgulama
- 📅 **Randevu Yönetimi**: Geçmiş ve gelecek randevuları listeleme
- 🔒 **Güvenli**: SOAP tabanlı güvenli iletişim
- 🚀 **Kolay Entegrasyon**: Claude Code, Claude Desktop ve diğer MCP istemcileriyle uyumlu
### 🛠️ Kurulum
#### Gereksinimler
- Python 3.10 veya üzeri
- e-Nabız API erişim bilgileri (kullanıcı adı ve şifre)
- Sağlık Bakanlığı KTS sistemi üzerinden onaylı erişim
#### Adım 1: Repoyu Klonlayın
```bash
git clone https://github.com/furkanisikay/enabiz-mcp-server.git
cd enabiz-mcp-server
```
#### Adım 2: Bağımlılıkları Yükleyin
```bash
# Virtual environment oluşturun (önerilen)
python -m venv venv
source venv/bin/activate # Linux/Mac
# veya
venv\Scripts\activate # Windows
# Bağımlılıkları yükleyin
pip install -e .
```
#### Adım 3: Yapılandırma
`.env` dosyası oluşturun:
```bash
cp .env.example .env
```
`.env` dosyasını düzenleyin ve e-Nabız bilgilerinizi ekleyin:
```env
ENABIZ_USERNAME=kullaniciadi
ENABIZ_PASSWORD=sifre
ENABIZ_API_URL=https://sys.sagliknet.saglik.gov.tr/SYS/SYSWS.svc
```
### 🚀 Kullanım
#### Claude Desktop ile Kullanım
`~/Library/Application Support/Claude/claude_desktop_config.json` dosyasını düzenleyin (Mac) veya `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
```json
{
"mcpServers": {
"enabiz": {
"command": "python",
"args": [
"-m",
"enabiz_mcp.server"
],
"env": {
"ENABIZ_USERNAME": "kullaniciadi",
"ENABIZ_PASSWORD": "sifre"
}
}
}
}
```
#### Claude Code ile Kullanım
Claude Code'da MCP sunucusunu etkinleştirin:
```bash
# Sunucuyu başlatın
python -m enabiz_mcp.server
```
#### Komut Satırından Test
```bash
# Sunucuyu başlatın
enabiz-mcp
```
### 📚 Kullanılabilir Araçlar (Tools)
| Araç | Açıklama | Parametreler |
|------|----------|--------------|
| `get_patient_info` | Hasta bilgilerini getir | `tc_no` (string, 11 haneli) |
| `get_health_records` | Sağlık kayıtlarını getir | `tc_no`, `start_date`, `end_date` |
| `get_prescriptions` | Reçete geçmişini getir | `tc_no`, `limit` |
| `get_lab_results` | Laboratuvar sonuçlarını getir | `tc_no`, `test_type` (opsiyonel) |
| `get_appointments` | Randevuları listele | `tc_no`, `status` (upcoming/past/all) |
### 🔐 Güvenlik ve Gizlilik
- ⚠️ **ÖNEMLİ**: Bu proje kişisel sağlık verileriyle çalışır
- Kullanıcı bilgilerini asla paylaşmayın veya log'lamayın
- KVKK (Kişisel Verilerin Korunması Kanunu) uyumlu kullanım sağlayın
- Üretim ortamında mutlaka HTTPS kullanın
- API anahtarlarını `.env` dosyasında tutun ve git'e eklemeyin
### 🤝 Katkıda Bulunma
Katkılarınızı bekliyoruz! Lütfen:
1. Fork yapın
2. Feature branch oluşturun (`git checkout -b feature/harika-ozellik`)
3. Değişikliklerinizi commit edin (`git commit -m 'Harika özellik eklendi'`)
4. Branch'inizi push edin (`git push origin feature/harika-ozellik`)
5. Pull Request açın
### 📝 Lisans
Bu proje MIT lisansı altında açık kaynak olarak sunulmaktadır. Detaylar için [LICENSE](LICENSE) dosyasına bakın.
### ⚖️ Yasal Uyarı
Bu proje resmi bir Sağlık Bakanlığı projesi **değildir**. Topluluk tarafından geliştirilen açık kaynak bir araçtır. Kullanımınız kendi sorumluluğunuzdadır ve tüm yasal düzenlemelere uymanız gerekmektedir.
### 📞 İletişim
- GitHub Issues: [Sorun bildirin](https://github.com/furkanisikay/enabiz-mcp-server/issues)
- Discussions: [Tartışmalara katılın](https://github.com/furkanisikay/enabiz-mcp-server/discussions)
### 🔗 Kaynaklar
- [Model Context Protocol Dokümantasyonu](https://modelcontextprotocol.io/)
- [e-Nabız Resmi Sitesi](https://enabiz.gov.tr/)
- [e-Nabız Entegrasyon Rehberi](https://rehber.enabiz.gov.tr/)
- [Anthropic Claude](https://www.anthropic.com/)
---
## <a name="english"></a>🇬🇧 English
### 📖 Overview
e-Nabız MCP Server is an open-source Model Context Protocol (MCP) server that integrates with Turkey's e-Nabız (National Health System). This project enables Claude, ChatGPT, and other AI assistants to securely interact with e-Nabız health data.
### ✨ Features
- 🏥 **Patient Information**: Query patient data using Turkish ID number
- 📋 **Health Records**: Access health records by date range
- 💊 **Prescription History**: View patient prescription history
- 🔬 **Lab Results**: Query test and laboratory results
- 📅 **Appointment Management**: List past and upcoming appointments
- 🔒 **Secure**: SOAP-based secure communication
- 🚀 **Easy Integration**: Compatible with Claude Code, Claude Desktop, and other MCP clients
### 🛠️ Installation
#### Requirements
- Python 3.10 or higher
- e-Nabız API credentials (username and password)
- Approved access through Ministry of Health KTS system
#### Step 1: Clone the Repository
```bash
git clone https://github.com/furkanisikay/enabiz-mcp-server.git
cd enabiz-mcp-server
```
#### Step 2: Install Dependencies
```bash
# Create virtual environment (recommended)
python -m venv venv
source venv/bin/activate # Linux/Mac
# or
venv\Scripts\activate # Windows
# Install dependencies
pip install -e .
```
#### Step 3: Configuration
Create a `.env` file:
```bash
cp .env.example .env
```
Edit the `.env` file and add your e-Nabız credentials:
```env
ENABIZ_USERNAME=your_username
ENABIZ_PASSWORD=your_password
ENABIZ_API_URL=https://sys.sagliknet.saglik.gov.tr/SYS/SYSWS.svc
```
### 🚀 Usage
#### With Claude Desktop
Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
```json
{
"mcpServers": {
"enabiz": {
"command": "python",
"args": [
"-m",
"enabiz_mcp.server"
],
"env": {
"ENABIZ_USERNAME": "your_username",
"ENABIZ_PASSWORD": "your_password"
}
}
}
}
```
#### With Claude Code
Enable the MCP server in Claude Code:
```bash
# Start the server
python -m enabiz_mcp.server
```
#### Test from Command Line
```bash
# Start the server
enabiz-mcp
```
### 📚 Available Tools
| Tool | Description | Parameters |
|------|-------------|------------|
| `get_patient_info` | Get patient information | `tc_no` (string, 11 digits) |
| `get_health_records` | Get health records | `tc_no`, `start_date`, `end_date` |
| `get_prescriptions` | Get prescription history | `tc_no`, `limit` |
| `get_lab_results` | Get laboratory results | `tc_no`, `test_type` (optional) |
| `get_appointments` | List appointments | `tc_no`, `status` (upcoming/past/all) |
### 🔐 Security and Privacy
- ⚠️ **IMPORTANT**: This project works with personal health data
- Never share or log user credentials
- Ensure GDPR/KVKK compliance
- Always use HTTPS in production
- Keep API keys in `.env` file and never commit to git
### 🤝 Contributing
Contributions are welcome! Please:
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
### 📝 License
This project is open source under the MIT License. See [LICENSE](LICENSE) file for details.
### ⚖️ Legal Disclaimer
This project is **not** an official Ministry of Health project. It is a community-developed open-source tool. Use at your own risk and ensure compliance with all applicable regulations.
### 📞 Contact
- GitHub Issues: [Report a bug](https://github.com/furkanisikay/enabiz-mcp-server/issues)
- Discussions: [Join the conversation](https://github.com/furkanisikay/enabiz-mcp-server/discussions)
### 🔗 Resources
- [Model Context Protocol Documentation](https://modelcontextprotocol.io/)
- [e-Nabız Official Website](https://enabiz.gov.tr/)
- [e-Nabız Integration Guide](https://rehber.enabiz.gov.tr/)
- [Anthropic Claude](https://www.anthropic.com/)
---
<div align="center">
**Türkiye'nin açık kaynak sağlık teknolojisi topluluğuna katkıda bulunun! 🇹🇷**
**Contribute to Turkey's open-source health tech community! 🇹🇷**
Made with ❤️ for the developer community
</div>
