resmi-gazete-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
İçindekiler
Related MCP server: free-search-mcp
Genel Bakış
resmi-gazete-cli, T.C. Resmi Gazete (resmigazete.gov.tr) üzerinde yayımlanan kararları, kanunları, yönetmelikleri ve ilanları terminal üzerinden sorgulamak ve LLM ajanlarına aktarmak üzere tasarlanmış asenkron bir araç setidir.
Üç temel arabirim sunar:
Python SDK:
httpxvepydantictabanlı, TLS doğrulamalı asenkron HTTP istemcisi.Terminal Arayüzü (CLI):
clickverichtabanlı, formatlanmış konsol çıktısı veren komut satırı aracı.Model Context Protocol (MCP) Sunucusu: LLM ajanlarının (Claude Desktop, Cursor vb.) günün gazetesini ve geçmiş sayıları doğrudan sorgulayabilmesini sağlayan
FastMCPstdio sunucusu.
Dokümantasyon
Detaylı kullanım ve entegrasyon kılavuzları docs/ dizini altında toplanmıştır:
Doküman | Kapsam |
Komut sihirbazı, interaktif mimari ve tarayıcı dostu kılavuz. | |
Sistem mimarisi, veri akış diyagramı ve genel yetenekler. | |
| |
FastMCP araçları, Claude Desktop, Cursor ve VS Code yapılandırma rehberi. | |
|
Mimari
Sistem bileşenleri ve katmanlar arası veri akışı aşağıdaki şemada gösterilmiştir:
flowchart TD
subgraph ClientLayer["Kullanıcı ve Entegrasyon Katmanı"]
CLI["CLI Arayüzü<br/>resmi-gazete-cli"]
MCP["FastMCP Sunucusu<br/>resmi-gazete-mcp"]
SDK["Python SDK<br/>ResmiGazeteClient"]
end
subgraph CoreLayer["Çekirdek Kütüphane (resmi_gazete_cli)"]
Client["ResmiGazeteClient<br/>(httpx.AsyncClient + TLS)"]
Models["Pydantic Veri Modelleri<br/>(GazetteItem, DailyGazette)"]
Parser["HTML & JSON Ayrıştırıcı<br/>(BeautifulSoup4 / lxml)"]
end
subgraph External["Dış Sistem"]
Target["T.C. Resmi Gazete Portalı<br/>resmigazete.gov.tr"]
end
CLI --> Client
MCP --> Client
SDK --> Client
Client --> Target
Target --> Client
Client --> Parser
Parser --> ModelsKurulum
1. Homebrew ile Kurulum (macOS & Linux)
Homebrew kullanıcıları tek satırla tap ekleyerek aracı kurabilir:
# Depoyu tap olarak ekleyin ve kurun
brew tap AtaCanYmc/resmi-gazete-cli https://github.com/AtaCanYmc/resmi-gazete-cli.git
brew install resmi-gazete-cliVeya AtaCanYmc/homebrew-tap üzerinden:
brew tap AtaCanYmc/tap
brew install resmi-gazete-cli2. PyPI Üzerinden Kurulum (Önerilen)
Paketi doğrudan PyPI üzerinden yükleyebilirsiniz:
pip install resmi-gazete-cliİzole bir CLI aracı olarak çalıştırmak için uv veya pipx kullanabilirsiniz:
# uv ile
uv tool install resmi-gazete-cli
# veya pipx ile
pipx install resmi-gazete-cli3. Kaynak Koddan Kurulum (Geliştirici Modu)
Projeye katkı sağlamak veya yerel olarak derlemek için:
# Depoyu klonlayın
git clone https://github.com/AtaCanYmc/resmi-gazete-cli.git
cd resmi-gazete-cli
# Sanal ortamı hazırlayın
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
# Bağımlılıkları yükleyin
pip install --upgrade pip
pip install -e .Hızlı Başlangıç
Kurulum tamamlandıktan sonra CLI sürümünü kontrol edin:
resmi-gazete-cli --versionKullanım
1. Komut Satırı Arayüzü (CLI)
Günlük Resmi Gazete (daily)
# Günün sayısını formatlanmış tablo olarak listele
resmi-gazete-cli daily
# Belirli bir tarihteki sayıyı listele (GG.AA.YYYY veya YYYY-MM-DD)
resmi-gazete-cli daily -d 17.11.2026
# Mükerrer sayıyı listele
resmi-gazete-cli daily -d 2026-10-27 -m 1
# Kategoriye göre filtrele (örn. Cumhurbaşkanı, Yönetmelik, Tebliğ, İlan)
resmi-gazete-cli daily -c "Yönetmelik"
# Çıktıyı JSON formatında al
resmi-gazete-cli daily -jArşiv ve Detaylı Arama (search)
# Anahtar kelime ile arama yap
resmi-gazete-cli search -k "vergi"
# Tarih aralığı ve mevzuat türü ile arama yap (kanun, teblig, yonetmelik, cb-karar, aym)
resmi-gazete-cli search -k "vergi" -t "teblig" -b 01.11.2026 -e 15.11.2026
# Resmi Gazete sayısına göre ara
resmi-gazete-cli search -s 33434
# Çıktıyı Markdown formatında al
resmi-gazete-cli search -k "yapay zeka" --format md
# Çıktıyı JSON formatında al
resmi-gazete-cli search -k "kvkk" --format json -l 202. Model Context Protocol (MCP) Sunucusu
Proje, LLM ajanlarının (Claude Desktop, Cursor, Windsurf, Cline vb.) Resmi Gazete verilerine canlı erişebilmesi için FastMCP stdio sunucusu içerir.
Sunulan MCP Araçları (Tools)
Araç Adı | Açıklama | Temel Parametreler |
| Güncel Resmi Gazete özetini, bölüm başlıklarını ve madde linklerini listeler. | Parametresiz |
| Belirli bir tarihteki Resmi Gazete sayısını listeler. |
|
| Arşivde anahtar kelime, tarih aralığı, sayı ve mevzuat türüyle parametrik arama yapar. |
|
| Karar veya yönetmeliğin metin içeriğini indirip temizler. |
|
Claude Desktop Entegrasyonu
Claude Desktop yapılandırma dosyanıza aşağıdaki bloğu ekleyin:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"resmi-gazete": {
"command": "resmi-gazete-mcp"
}
}
}Sanal ortam ile çalıştırmak isterseniz mutlak python yolunu belirtin:
{
"mcpServers": {
"resmi-gazete": {
"command": "/Users/KULLANICI_ADI/PycharmProjects/resmi-gazete-cli/.venv/bin/python",
"args": ["-m", "resmi_gazete_cli.mcp.server"]
}
}
}Cursor Entegrasyonu
Cursor ayarlarını açın: Settings > Features > MCP.
Add New MCP Server butonuna tıklayın.
Bilgileri girin:
Name:
resmi-gazeteType:
commandCommand:
resmi-gazete-mcp(veya sanal ortam yolu:/path/to/.venv/bin/resmi-gazete-mcp)
Sunucuyu kaydedip yeşil durum ışığını doğrulayın. Cursor Agent veya Composer içinde "Günün Resmi Gazete kararlarını getir" veya "Vergi Usul Kanunu tebliğlerini ara" komutlarını verebilirsiniz.
VS Code (Cline / Roo Code) Entegrasyonu
cline_mcp_settings.json içerisine ekleyin:
{
"mcpServers": {
"resmi-gazete": {
"command": "resmi-gazete-mcp",
"disabled": false,
"autoApprove": [
"get_todays_gazette",
"get_gazette_by_date",
"search_gazette",
"get_document_content"
]
}
}
}3. Python Kütüphanesi Olarak Kullanım
ResmiGazeteClient sınıfını doğrudan asenkron Python projelerinizde kullanabilirsiniz:
import asyncio
from resmi_gazete_cli import ResmiGazeteClient
async def main():
async with ResmiGazeteClient() as client:
gazette = await client.get_todays_gazette()
print(f"Tarih: {gazette.date}, Sayı: {gazette.number}")
for category in gazette.categories:
print(f"\n## {category.main_category}")
for item in category.items:
print(f" - {item.title} -> {item.url}")
if __name__ == "__main__":
asyncio.run(main())Proje Dizini Yapısı
resmi-gazete-cli/
├── pyproject.toml # Hatchling derleme ve bağımlılık manifestosu
├── Makefile # Test, lint ve derleme otomasyon görevleri
├── README.md # Temel dokümantasyon ve vitrin
├── CONTRIBUTING.md # Geliştirici katkı kuralları
├── SECURITY.md # Güvenlik politikası ve bildirim SLA'sı
├── ROADMAP.md # Sürüm kilometre taşları
├── LICENSE # Apache-2.0 lisans metni
├── .editorconfig # Evrensel editör biçimlendirme kuralları
├── .gitattributes # Satır sonu (LF) ve ikili dosya kuralları
├── .markdownlint.json # Markdown linter yapılandırması
├── .flake8 # Python linter kuralları
├── release-please-config.json # Otomatik sürümleme yapılandırması
├── .release-please-manifest.json # Sürüm takip manifestosu
├── Formula/ # Homebrew tap formülü
│ └── resmi-gazete-cli.rb # Homebrew kurulum reçetesi
├── docs/ # Detaylı teknik kılavuzlar
│ ├── index.md # Dokümantasyon indeksi ve sistem mimarisi
│ ├── cli.md # CLI komut referansı (daily, search)
│ ├── mcp.md # Model Context Protocol ve LLM entegrasyonu
│ ├── sdk.md # Python SDK referansı ve modeller
│ └── assets/
│ └── logo.svg # Vektörel kurumsal logo
├── .github/
│ ├── CODEOWNERS # PR otomatik denetçi atamaları
│ ├── dependabot.yml # Bağımlılık güncelleme planlayıcısı
│ ├── ISSUE_TEMPLATE/ # Hata ve özellik talep şablonları
│ ├── PULL_REQUEST_TEMPLATE/ # PR kontrol listesi şablonu
│ └── workflows/
│ ├── ci.yml # Otomatik test ve derleme iş akışı
│ └── release-please.yml # Sürüm ve etiket otomasyonu
├── resmi_gazete_cli/
│ ├── __init__.py # Paket dışa aktarımları ve sürüm sabiti
│ ├── scraper/
│ │ ├── __init__.py
│ │ ├── client.py # HTTP istemcisi ve hata yönetimi
│ │ ├── models.py # Pydantic veri modelleri
│ │ ├── parser.py # HTML gazete ayrıştırıcısı
│ │ └── security.py # SSRF ve URL doğrulama güvenlik kontrolleri
│ ├── cli/
│ │ ├── __init__.py
│ │ └── main.py # Click terminal komutları
│ └── mcp/
│ ├── __init__.py
│ └── server.py # FastMCP stdio sunucusu
└── tests/
├── __init__.py
├── test_cli.py # CLI komut testleri
├── test_client.py # İstemci ve HTTP mock testleri
├── test_mcp.py # FastMCP araç testleri
├── test_models.py # Pydantic model doğrulama testleri
├── test_parser.py # HTML parser ve normalizasyon testleri
└── test_security.py # SSRF, DoS ve enjeksiyon güvenlik testleriGeliştirme ve Test
Geliştirici ortamında testleri ve kod stili kontrollerini çalıştırmak için:
# Linter kontrolü
flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
# Testleri çalıştırın
pytestSıkça Sorulan Sorular (SSS)
Resmi Gazete sunucusu istekleri engelliyor mu?
Hedef sistem resmigazete.gov.tr, belirli bir frekansın üzerindeki isteklerde veya geçersiz User-Agent başlıklarında bağlantıyı reddedebilir. ResmiGazeteClient varsayılan olarak gerçekçi tarayıcı başlıkları kullanır ve yeniden deneme/zaman aşımı yönetimini destekler.
Bu araç resmi bir kamu projesi midir?
Hayır. Bu araç bağımsız bir açık kaynak projesidir ve T.C. Cumhurbaşkanlığı İdari İşler Başkanlığı ya da Resmi Gazete kurumu ile doğrudan resmi bir bağı bulunmamaktadır.
Karar ve ilan metinleri çevrimdışı önbelleğe alınıyor mu?
Varsayılan istemci canlı HTTP sorguları yapar. Ağ trafiğini optimize etmek veya toplu analiz gerçekleştirmek isteyen kullanıcılar dönen GazetteItem modellerini yerel SQLite ya da dosya sistemine kaydedebilir.
Lisans
Bu proje Apache-2.0 lisansı ile dağıtılmaktadır.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
OCR, transcription, file extraction, and image generation for AI agents via MCP.
Unified 15-tool SEO, SERP, clean Markdown & GEO (LLM citation Share-of-Voice) MCP server.
Web search API and MCP server for developers building AI agents.
Furgonetka MCP Server is an extension for LLMs (such as Claude) that integrates AI assistants with Poland's most popular courier brokerage platform. The server enables models to interact directly with services from various couriers (including InPost, DPD, DHL, UPS, and Poczta Polska) through a single, unified interface. With this integration, your AI stops just "writing about logistics" and starts actually managing it.
Related MCP Servers
- FlicenseBqualityDmaintenanceA Model Context Protocol server that enables Claude users to access specialized OpenAI agents (web search, file search, computer actions) and a multi-agent orchestrator through the MCP protocol.410-
- AlicenseAqualityBmaintenanceA local-first, no-API-key MCP server that enables LLMs to search the web, fetch pages, and read documents using multiple engines and smart fallbacks.611181MIT
- AlicenseAqualityDmaintenanceMCP server that bridges OpenAI's Agents SDK with Claude Code, enabling web search, file search, and computer use capabilities directly in your development environment.29 npm1MIT
- FlicenseNot gradedqualityDmaintenanceA FastMCP server that exposes a locally-hosted llama.cpp LLM as MCP tools, plus utilities for weather, news, web fetching, file I/O, and more. Enables MCP-compatible clients to use a local GGUF model for text generation without external APIs.1-