Yargı MCP

Instructions

Implementation Reference

• uyusmazlik_mcp_module/client.py:75-194 (handler)

  The main handler function that executes the tool logic: maps user-friendly enums to API IDs, constructs form data, performs POST request to Uyusmazlik Mahkemesi search endpoint, parses HTML response with BeautifulSoup, and returns structured decision entries.
  async def search_decisions( self, params: UyusmazlikSearchRequest ) -> UyusmazlikSearchResponse: bolum_id_for_api = BOLUM_ENUM_TO_ID_MAP.get(params.bolum, "") uyusmazlik_id_for_api = UYUSMAZLIK_TURU_ENUM_TO_ID_MAP.get(params.uyusmazlik_turu, "") form_data_list: List[Tuple[str, str]] = [] def add_to_form_data(key: str, value: Optional[str]): # API expects empty strings for omitted optional fields based on user payload example form_data_list.append((key, value or "")) add_to_form_data("BolumId", bolum_id_for_api) add_to_form_data("UyusmazlikId", uyusmazlik_id_for_api) if params.karar_sonuclari: for enum_member in params.karar_sonuclari: api_id = KARAR_SONUCU_ENUM_TO_ID_MAP.get(enum_member) if api_id: # Only add if a valid ID is found form_data_list.append(('KararSonucuList', api_id)) add_to_form_data("EsasYil", params.esas_yil) add_to_form_data("EsasSayisi", params.esas_sayisi) add_to_form_data("KararYil", params.karar_yil) add_to_form_data("KararSayisi", params.karar_sayisi) add_to_form_data("KanunNo", params.kanun_no) add_to_form_data("KararDateBegin", params.karar_date_begin) add_to_form_data("KararDateEnd", params.karar_date_end) add_to_form_data("ResmiGazeteSayi", params.resmi_gazete_sayi) add_to_form_data("ResmiGazeteDate", params.resmi_gazete_date) add_to_form_data("Icerik", params.icerik) add_to_form_data("Tumce", params.tumce) add_to_form_data("WildCard", params.wild_card) add_to_form_data("Hepsi", params.hepsi) add_to_form_data("Herhangibirisi", params.herhangi_birisi) add_to_form_data("NotHepsi", params.not_hepsi) # Convert form data to dict for httpx form_data_dict = {} for key, value in form_data_list: if key in form_data_dict: # Handle multiple values (like KararSonucuList) if not isinstance(form_data_dict[key], list): form_data_dict[key] = [form_data_dict[key]] form_data_dict[key].append(value) else: form_data_dict[key] = value logger.info(f"UyusmazlikApiClient (httpx): Performing search to {self.SEARCH_ENDPOINT} with form_data: {form_data_dict}") try: # Use shared httpx client response = await self.http_client.post( self.SEARCH_ENDPOINT, data=form_data_dict, headers={"Content-Type": "application/x-www-form-urlencoded; charset=UTF-8"} ) response.raise_for_status() html_content = response.text logger.debug("UyusmazlikApiClient (httpx): Received HTML response for search.") except httpx.HTTPError as e: logger.error(f"UyusmazlikApiClient (httpx): HTTP client error during search: {e}") raise # Re-raise to be handled by the MCP tool except Exception as e: logger.error(f"UyusmazlikApiClient (httpx): Error processing search request: {e}") raise # --- HTML Parsing (remains the same as previous version) --- soup = BeautifulSoup(html_content, 'html.parser') total_records_text_div = soup.find("div", class_="pull-right label label-important") total_records = None if total_records_text_div: match_records = re.search(r'(\d+)\s*adet kayıt bulundu', total_records_text_div.get_text(strip=True)) if match_records: total_records = int(match_records.group(1)) result_table = soup.find("table", class_="table-hover") processed_decisions: List[UyusmazlikApiDecisionEntry] = [] if result_table: rows = result_table.find_all("tr") if len(rows) > 1: # Skip header row for row in rows[1:]: cols = row.find_all('td') if len(cols) >= 5: try: popover_div = cols[0].find("div", attrs={"data-rel": "popover"}) popover_content_raw = popover_div["data-content"] if popover_div and popover_div.has_attr("data-content") else None link_tag = cols[0].find('a') doc_relative_url = link_tag['href'] if link_tag and link_tag.has_attr('href') else None if not doc_relative_url: continue document_url_str = urljoin(self.BASE_URL, doc_relative_url) pdf_link_tag = cols[5].find('a', href=re.compile(r'\.pdf$', re.IGNORECASE)) if len(cols) > 5 else None pdf_url_str = urljoin(self.BASE_URL, pdf_link_tag['href']) if pdf_link_tag and pdf_link_tag.has_attr('href') else None decision_data_parsed = { "karar_sayisi": cols[0].get_text(strip=True), "esas_sayisi": cols[1].get_text(strip=True), "bolum": cols[2].get_text(strip=True), "uyusmazlik_konusu": cols[3].get_text(strip=True), "karar_sonucu": cols[4].get_text(strip=True), "popover_content": html.unescape(popover_content_raw) if popover_content_raw else None, "document_url": document_url_str, "pdf_url": pdf_url_str } decision_model = UyusmazlikApiDecisionEntry(**decision_data_parsed) processed_decisions.append(decision_model) except Exception as e: logger.warning(f"UyusmazlikApiClient: Could not parse decision row. Row content: {row.get_text(strip=True, separator=' | ')}, Error: {e}") return UyusmazlikSearchResponse( decisions=processed_decisions, total_records_found=total_records )
• uyusmazlik_mcp_module/models.py:29-66 (schema)

  Pydantic input schema for the MCP tool, defining user-friendly fields and enums for searching Uyusmazlik decisions.
  class UyusmazlikSearchRequest(BaseModel): # This is the model the MCP tool will accept """Model for Uyuşmazlık Mahkemesi search request using user-friendly terms.""" icerik: Optional[str] = Field("", description="Search text") bolum: Optional[UyusmazlikBolumEnum] = Field( UyusmazlikBolumEnum.TUMU, description="Department" ) uyusmazlik_turu: Optional[UyusmazlikTuruEnum] = Field( UyusmazlikTuruEnum.TUMU, description="Dispute type" ) # User provides a list of user-friendly names for Karar Sonucu karar_sonuclari: Optional[List[UyusmazlikKararSonucuEnum]] = Field( # Changed to list of Enums default_factory=list, description="Decision types" ) esas_yil: Optional[str] = Field("", description="Case year") esas_sayisi: Optional[str] = Field("", description="Case no") karar_yil: Optional[str] = Field("", description="Decision year") karar_sayisi: Optional[str] = Field("", description="Decision no") kanun_no: Optional[str] = Field("", description="Law no") karar_date_begin: Optional[str] = Field("", description="Start date (DD.MM.YYYY)") karar_date_end: Optional[str] = Field("", description="End date (DD.MM.YYYY)") resmi_gazete_sayi: Optional[str] = Field("", description="Gazette no") resmi_gazete_date: Optional[str] = Field("", description="Gazette date (DD.MM.YYYY)") # Detailed text search fields from the "icerikDetail" section of the form tumce: Optional[str] = Field("", description="Exact phrase") wild_card: Optional[str] = Field("", description="Wildcard search") hepsi: Optional[str] = Field("", description="All words") herhangi_birisi: Optional[str] = Field("", description="Any word") not_hepsi: Optional[str] = Field("", description="Exclude words")
• uyusmazlik_mcp_module/models.py:78-82 (schema)

  Pydantic output schema returned by the MCP tool, containing list of decision entries and total count.
  class UyusmazlikSearchResponse(BaseModel): # This is what the MCP tool will return """Response model for Uyuşmazlık Mahkemesi search results for the MCP tool.""" decisions: List[UyusmazlikApiDecisionEntry] total_records_found: Optional[int] = Field(None, description="Total number of records found for the query, if available.")
• uyusmazlik_mcp_module/client.py:28-50 (helper)

  Helper mappings that convert user-friendly enum values from the input schema to internal API GUID IDs required by the Uyusmazlik Mahkemesi search endpoint.
  BOLUM_ENUM_TO_ID_MAP = { UyusmazlikBolumEnum.CEZA_BOLUMU: "f6b74320-f2d7-4209-ad6e-c6df180d4e7c", UyusmazlikBolumEnum.GENEL_KURUL_KARARLARI: "e4ca658d-a75a-4719-b866-b2d2f1c3b1d9", UyusmazlikBolumEnum.HUKUK_BOLUMU: "96b26fc4-ef8e-4a4f-a9cc-a3de89952aa1", UyusmazlikBolumEnum.TUMU: "", # Represents "...Seçiniz..." or all - empty string for API "ALL": "" # Also map the new "ALL" literal to empty string for backward compatibility } UYUSMAZLIK_TURU_ENUM_TO_ID_MAP = { UyusmazlikTuruEnum.GOREV_UYUSMAZLIGI: "7b1e2cd3-8f09-418a-921c-bbe501e1740c", UyusmazlikTuruEnum.HUKUM_UYUSMAZLIGI: "19b88402-172b-4c1d-8339-595c942a89f5", UyusmazlikTuruEnum.TUMU: "", # Represents "...Seçiniz..." or all - empty string for API "ALL": "" # Also map the new "ALL" literal to empty string for backward compatibility } KARAR_SONUCU_ENUM_TO_ID_MAP = { # These IDs are from the form HTML provided by the user UyusmazlikKararSonucuEnum.HUKUM_UYUSMAZLIGI_OLMADIGINA_DAIR: "6f47d87f-dcb5-412e-9878-000385dba1d9", UyusmazlikKararSonucuEnum.HUKUM_UYUSMAZLIGI_OLDUGUNA_DAIR: "5a01742a-c440-4c4a-ba1f-da20837cffed", # Add all other 'Karar Sonucu' enum members and their corresponding GUIDs # by inspecting the 'KararSonucuList' checkboxes in the provided form HTML. } # --- End Mappings ---
• uyusmazlik_mcp_module/models.py:8-29 (helper)

  User-friendly enum definitions used in the input schema for department, dispute type, and decision result selections.
  class UyusmazlikBolumEnum(str, Enum): """User-friendly names for 'BolumId'.""" TUMU = "ALL" # Represents "...Seçiniz..." or all CEZA_BOLUMU = "Ceza Bölümü" GENEL_KURUL_KARARLARI = "Genel Kurul Kararları" HUKUK_BOLUMU = "Hukuk Bölümü" class UyusmazlikTuruEnum(str, Enum): """User-friendly names for 'UyusmazlikId'.""" TUMU = "ALL" # Represents "...Seçiniz..." or all GOREV_UYUSMAZLIGI = "Görev Uyuşmazlığı" HUKUM_UYUSMAZLIGI = "Hüküm Uyuşmazlığı" class UyusmazlikKararSonucuEnum(str, Enum): # Based on checkbox text in the form """User-friendly names for 'KararSonucuList' items.""" HUKUM_UYUSMAZLIGI_OLMADIGINA_DAIR = "Hüküm Uyuşmazlığı Olmadığına Dair" HUKUM_UYUSMAZLIGI_OLDUGUNA_DAIR = "Hüküm Uyuşmazlığı Olduğuna Dair" # Add other "Karar Sonucu" options from the form's checkboxes as Enum members # Example: GOREVLI_YARGI_YERI_ADLI = "Görevli Yargı Yeri Belirlenmesine Dair (Adli Yargı)" # The client will map these enum values (which are strings) to their respective IDs. class UyusmazlikSearchRequest(BaseModel): # This is the model the MCP tool will accept