Repository avatar
Other Tools
v0.19.0
active

uyap-editor-mcp

io.github.Umutoku/uyap-editor-mcp

Local UYAP Document Editor tools for Windows x64

Documentation

UYAP Editor MCP

UYAP Doküman Editörü 5.4.20’yi Windows x64’te yerel olarak kullanan 65 araçlık bir MCP sunucusu. UDF açabilir, sayfalar arasında gezebilir, belgeyi düzenleyebilir ve editörün kendi menüleriyle çıktı alabilirsin. Codex ile belge akışı doğrulandı. Claude, Gemini CLI, Antigravity ve OpenCode için kurulum ve test durumu aşağıda yer alıyor.

Bu, bağımsız bir açık kaynak projesidir. UYAP Doküman Editörü’nü Adalet Bakanlığının resmî sitesinden ayrı kur.

UYAP Doküman Editörü’nde kurgu inceleme notu ve sağda üç yorum

Gerçek UYAP penceresinde kurgu inceleme notu ve yorumları. IMZ dışa aktarma ayrı bir kurgu CMS imzalı UDF ile doğrulandı.

Sunucu Windows’ta ayrı bir süreç olarak çalışır. İstemci araç çağrılarını ve sonuçlarını stdio üzerinden alır ve gönderir. Proje belge, kullanım verisi veya telemetri toplamaz. Belge metnini isteyen bir çağrı yaparsan seçtiğin AI istemcisi bu metni alır ve kendi veri politikasını uygular. Gizlilik ve veri akışı

Windows kurulumu · İlk deneme · Kaldırma · Test durumu · MCP katalogları

Nasıl çalışır

UYAP Editor MCP mimarisi

İstemcide “UDF’yi aç, üçüncü sayfaya git ve bir PDF oluştur” diye yazarsın. İstemci sırayla uyap_open, uyap_go_to_page ve uyap_export_pdf araçlarını çağırır. Yerel MCP, Java köprüsüyle UYAP’ın belge motoruna ve menülerine erişir. İstemciye belge kimliğini, doğrulanan sayfayı, PDF yolunu ve çıktı özetini döndürür. Bu akış için MCP bağlantısı yeterlidir.

Sunucu çalışma kopyasını belirlediğin yerel klasörlerde işler. Girdi, çıktı ve dosya biçimi denetlenir. Çıktı başarıyla oluşunca istemci sonucu alır. Bir klasördeki birden çok belge için aynı akış toplu dönüştürmeyle yürütülebilir.

MCP ve UYAP, aynı etkileşimli Windows oturumunda çalışır. Editör gerektiğinde pencere açabilir. E-posta gönderimi, kart veya mobil imza ve portal kaydı gibi işlemlerin son onayı ilgili uygulama ya da cihazda yapılır.

Neler yapar

İşlemÖrnek araçlar
UDF açma, gezinme ve PDFuyap_open, uyap_go_to_page, uyap_export_pdf
Metin, liste, yorum ve şablonuyap_replace_text, uyap_set_custom_list, uyap_add_comment, uyap_open_template
Dönüştürme, yedek ve IMZuyap_batch_export, uyap_restore_backup, uyap_export_signed_imz
Parolalı yerel arşivuyap_encrypt_7z, uyap_extract_7z
Kullanıcı onayına hazırlıkuyap_prepare_approval e-posta eki, yazdırma, imza ve portal kayıt akışlarını ilgili onay adımına hazırlar.

Eylem envanteri

Windows kurulumu

  1. GitHub Releases üzerinden Windows x64 ZIP’ini indir ve C:\Tools\uyap-editor-mcp gibi yerel bir klasöre aç.
  2. Resmî UYAP Editör sürümünü kur. editor_lib.jar dosyasının bulunduğu klasörü belirle.
  3. Var olan uyumlu Java 8 x64 kurulumunun bin klasörünü kullan. Bu klasörde java.exe ve WindowsAccessBridge-64.dll bulunur.

0.19 Windows paketinde .NET çalışma zamanı arşivin içine dahildir. Java, editörün çalışması ve Java Access Bridge üzerinden penceresine erişim için kullanılır. .exe, MCP istemcisinin yerel sunucuyu başlattığı Windows dosyasıdır. 7z araçları için ayrıca 7-Zip gerekir.

Eski 0.18.0 önizlemesi ayrı .NET 10 x64 çalışma zamanı ister. O sürümün çevrimiçi tarama bulgusu sürüm notunda bulunur.

Hızlı kurulum

0.19 ZIP’ini açtığın klasörde PowerShell’i başlat. Kurulum iki klasör seçtirir ve MCP’yi Windows kullanıcı hesabına kurar. Codex kullanıyorsan kayıt işlemini de tek komutla yapabilirsin.

.\Setup-Windows.ps1 -Client Codex -Register

Diğer istemciler için aynı komutun ürettiği JSON’u ilgili yapılandırmaya ekle. -Client değeri olarak ClaudeCode, ClaudeDesktop, Gemini, Antigravity veya OpenCode kullanabilirsin.

.\Setup-Windows.ps1 -Client OpenCode

Belge ve çıktılarını %LOCALAPPDATA%\UyapEditorMcpData altındaki in ve out klasörlerinde bulursun. Kendi belge klasörlerini seçmek için aşağıdaki elle kurulumda yolları değiştir.

PowerShell hazırlığı

Aşağıdaki üç yolu kendi bilgisayarına göre değiştir. Girdi olarak önce paketteki fixtures klasörünü kullan.

$root = 'C:/Tools/uyap-editor-mcp'
$editor = 'C:/UYAP/Editor'
$javaBin = 'C:/Java/jre8/bin'

$exe = "$root/app/UyapEditorMcp.exe"
$inputDir = "$root/fixtures"
$outputDir = "$root/exports"
$stateDir = "$root/.state"
New-Item -ItemType Directory -Force -Path $outputDir,$stateDir | Out-Null

$serverArgs = @(
  '--editor-dir', $editor,
  '--java-bin', $javaBin,
  '--input-root', $inputDir,
  '--output-root', $outputDir,
  '--state-dir', $stateDir
)

Codex

codex mcp add uyap_editor -- $exe @serverArgs
codex mcp list

Yeni bir Codex oturumunda uyap_status ve uyap_open araçlarını ara. Codex MCP belgeleri

Claude Code

claude mcp add --scope local --transport stdio uyap_editor -- $exe @serverArgs
claude mcp list

Proje klasöründen Claude Code’u aç ve /mcp ile durumu kontrol et. Claude Code MCP belgeleri

Claude Desktop

GitHub Releases’teki Windows .mcpb paketini Claude Desktop’a ekle. Yapılandırma ekranında UYAP, Java, girdi, çıktı ve durum klasörlerini seç. Elle kurulum için PowerShell’de aşağıdaki JSON’u üret ve mevcut claude_desktop_config.json içindeki mcpServers nesnesine kaydı ekle. Claude Desktop’ı yeniden başlat. Claude Desktop yerel MCP kurulumu

@{ mcpServers = @{ uyap_editor = @{ command = $exe; args = $serverArgs } } } |
  ConvertTo-Json -Depth 8

Gemini CLI

JSON çıktısını güvenilen projenin .gemini/settings.json dosyasındaki mcpServers nesnesine ekle. Son komut bağlantıyı kontrol eder. Gemini CLI MCP belgeleri

@{ mcpServers = @{ uyap_editor = @{ command = $exe; args = $serverArgs; trust = $false } } } |
  ConvertTo-Json -Depth 8
gemini mcp list

Antigravity

Antigravity’nin MCP ayarlarından ham yapılandırmayı aç. Üretilen uyap_editor kaydını mevcut mcpServers nesnesine ekle. Antigravity MCP belgeleri

@{ mcpServers = @{ uyap_editor = @{ command = $exe; args = $serverArgs } } } |
  ConvertTo-Json -Depth 8

OpenCode

OpenCode v2’de güvenilen proje klasöründen sunucuyu ekle. Elle kurulumda aynı sunucu opencode.jsonc içindeki mcp.servers alanına, type değeri local olan bir komut dizisiyle eklenir. OpenCode MCP belgeleri

opencode mcp add uyap_editor -- $exe @serverArgs
opencode mcp list

OpenCode 1 kullanıyorsan aşağıdaki komutun çıktısını proje yapılandırmasındaki mcp alanına ekle.

.\Setup-Windows.ps1 -Client OpenCode -OpenCodeVersion 1

İlk deneme

UYAP MCP ile önce editör sürümünü kontrol et. Girdi klasöründeki sentetik-3-sayfa.udf dosyasını aç. Üçüncü sayfaya git. Çıktı klasöründe kurgu-deneme.pdf oluştur ve PDF’nin üç sayfa olduğunu doğrula.

flowchart LR
    A["Girdi klasörü · kurgu UDF"] --> B["Yerel UYAP oturumu · çalışma kopyası"]
    B --> C["Üçüncü sayfa"]
    C --> D["Çıktı klasörü · üç sayfalık PDF"]

Kaldırma

Önce istemcideki uyap_editor kaydını kaldır. Codex ve Claude Code için kayıt oluşturduğun kapsamda şu komutları kullan.

codex mcp remove uyap_editor
claude mcp remove uyap_editor

Claude Desktop’ta MCPB uzantısını ayarlardan kaldır. Elle yapılandırdıysan Claude Desktop, Gemini CLI ve Antigravity’de mcpServers.uyap_editor kaydını sil. OpenCode 2’de yol mcp.servers.uyap_editor, OpenCode 1’de mcp.uyap_editor. İstemciyi yeniden başlat. Sonra ZIP’i açtığın klasörde yerel kurulum dosyalarını kaldır.

.\Setup-Windows.ps1 -Uninstall

Kurucuyla yapılan kurulumdaki program dosyaları kaldırılır. UyapEditorMcpData içindeki belgeler ve çıktılar korunur. Taşınabilir ZIP’i elle kullanmışsan, istemci kaydını kaldırdıktan sonra açtığın program klasörünü silebilirsin.

Test durumu

KontrolSonuç
CodexKurgu UDF açma, üçüncü sayfa, PDF, IMZ ve 7z doğrulandı.
.NET stdio kabulü65 araç, kaynak açıklamaları, PDF, 7z ve 16 onay hazırlığı doğrulandı.
Claude Code ve Gemini CLIYerel MCP bağlantısı doğrulandı. Belge üzerinden uçtan uca istemci testi açık.
Claude DesktopMCPB manifesti doğrulandı. Uygulama içi kurulum ve belge testi açık.
Antigravity ve OpenCodeWindows yerel stdio kurulumları belgelendi. OpenCode yerel sunucuya bağlandı. Antigravity uygulama testi açık.
Yerel UYAP eylemleri244/275 tam kabul. E-posta teslimatı, yazıcıya gönderim, kart, mobil imza ve portalın son adımları ayrı kayıtlarda.

0.19 Windows paketi etkileşimli Windows x64 masaüstünde test edildi. Sürümün kapsamı doğrulanan yerel belge işlemleridir. Test ortamında gerçek akıllı kart, nitelikli e-imza ve Windows sanal makinesi bulunmuyordu. Kurgu imzalı UDF’den IMZ dışa aktarımı doğrulandı. Kart ve mobil imza ile imzalama, UYAP’ta kart sertifikası doğrulama ve yetkili portal kaydı açık.

Kalan 31 eylem kaydının 5’i imza, sertifika ve portal işlemlerine, 10’u son kullanıcı adımı açık olan e-posta, yazdırma ve editör ayarlarına ait. Diğer 16 kayıt, 15 editör içi işleyici ile 5.4.20’de kapalı olan yerel şifreleme eylemini kapsar. Yerel şifreleme için MCP’nin AES korumalı 7z oluşturma ve açma akışı geçti.

Test kayıtları ve komutları · Güvenlik kontrolleri ve yayımlanan bulgular

MCP katalogları

Windows ZIP ve MCPB paketleri GitHub Releases üzerinden indirilebilir. io.github.Umutoku/uyap-editor-mcp kaydı resmî MCP Registry’de yayında. Uygulama içi mağazalar kendi başvuru ve inceleme süreçlerini yürütür. Katalog durumu

Geliştirme

Visual Studio’da UyapEditorMcp.sln dosyasını aç. Geliştirme için .NET 10 SDK ve Java 8 hedefini derleyebilen bir JDK gerekir. Son kullanıcı arşivi derleme araçları gerektirmez. Kaynaktan derleme · Mimari · Kod kalitesi

Projenin kaynak kodu MIT lisansıyla yayımlanır. UYAP Doküman Editörü ayrı kurulur. Paketle gelen üçüncü taraf bileşenlerin lisansları kendi bildirimlerinde yer alır. MIT lisansı · Üçüncü taraf bildirimleri

MCPB
https://github.com/Umutoku/uyap-editor-mcp/releases/download/v0.19.0/uyap-editor-mcp-0.19.0-windows-x64.mcpb
Install Command
# mcpb: https://github.com/Umutoku/uyap-editor-mcp/releases/download/v0.19.0/uyap-editor-mcp-0.19.0-windows-x64.mcpb