resmi-gazete-mcp

Model Context Protocol (MCP) sunucusu — Türkiye Cumhuriyeti Resmî Gazete (resmigazete.gov.tr) içeriğini LLM istemcilerine (Claude Desktop, Claude Code, vb.) araç çağrılarıyla sunar.

Özellikler

Dört MCP aracı sağlar:

| Araç | Açıklama | | --- | --- | | get_fihrist | Belirli bir tarihin fihristini (bölümler ve madde URL'leri) döndürür. Mükerrer sayıları da dahildir. | | read_article | Tekil bir .htm madde sayfasından başlık ve temizlenmiş düz metin çıkarır. | | search_gazette | Tarih aralığı + anahtar kelime ile fihrist başlıklarında arama yapar (Türkçe normalize). | | extract_pdf_text | .pdf URL'inden metin ve sayfa sayısı çıkarır. |

Tüm HTTP istekleri yerel diskte cache'lenir (~/.cache/resmi-gazete-mcp/ — RESMI_GAZETE_CACHE_DIR ile değiştirilebilir).

Kurulum

Repo'yu klonlamaya gerek yok — paket npm üzerinden npx ile doğrudan çalışır. Node.js ≥ 20 gerekir.

npx -y resmi-gazete-mcp

Claude Desktop Konfigürasyonu

claude_desktop_config.json dosyanıza:

{
  "mcpServers": {
    "resmi-gazete": {
      "command": "npx",
      "args": ["-y", "resmi-gazete-mcp"]
    }
  }
}

Claude Code Konfigürasyonu

claude mcp add resmi-gazete -- npx -y resmi-gazete-mcp

Yerel Geliştirme (Opsiyonel)

Kaynak üzerinden çalıştırmak isterseniz:

git clone https://github.com/emircanok/resmi-gazete-mcp.git
cd resmi-gazete-mcp
npm install
npm run build
node dist/index.js

Geliştirme

npm run dev        # tsx ile doğrudan çalıştır
npm run typecheck  # tip kontrolü
npm run build      # dist/ içine derle

MCP Inspector ile Test

npx @modelcontextprotocol/inspector npx -y resmi-gazete-mcp

Örnek Çağrılar

get_fihrist:

{ "date": "2026-04-17", "includeMukerrer": true }

read_article:

{ "url": "https://www.resmigazete.gov.tr/eskiler/2026/04/20260417-1.htm" }

search_gazette:

{ "query": "vergi", "fromDate": "2026-04-01", "toDate": "2026-04-17", "maxResults": 20 }

extract_pdf_text:

{ "url": "https://www.resmigazete.gov.tr/eskiler/2026/04/20260417-1.pdf" }

Notlar

• Resmî Gazete Pazar günleri yayımlanmaz; search_gazette Pazar günlerini atlar.
• Site User-Agent başlığı olmadan 403 döndürür; sunucu uygun UA gönderir.
• Arama geniş aralıklarda yavaş olabilir — aynı gün tekrar sorgulandığında cache devreye girer.
• Maksimum arama aralığı 2 yıldır. PDF'ler için 25 MB sınırı vardır.

Lisans

MIT