使用说明（简要概览，便于快速上手）：

• 项目简介
  • 该仓库实现了一个完整的 MCP 服务器，提供 33 项 MCP 工具，用于访问与查询多家 Turkish legal 数据库（包括 Yargıtay、Danıştay、Anayasa Mahkemesi、Sayıştay、KVKK、BDDK、KIK、Bedesten 等），并通过 FastMCP/ASGI 框架与客户端进行 JSON-RPC 风格的交互。
• 主要功能点
  • MCP 核心功能：资源管理、工具注册与执行、提示模板渲染，统一通过 JSON-RPC 向 LLM 客户端暴露能力。
  • 会话与认证：内置 Bearer Token/ Clerk 集成的授权策略，支持多种认证模式与访问控制。
  • 数据源覆盖：跨机构的检索工具、文档获取与 Markdown 化输出，包含综合 Bedesten、UYAP/Emsal、Anayasa norm/bireysel、KIK、Rekabet、KVKK、BDDK 等等。
  • 语义检索（可选）：OpenRouter/OpenRouter APIKEY 条件下启用语义检索，使用向量 embeddeding 进行排序与返回。
  • 部署与集成：提供 ASGI/FastAPI 应用、Web 部署、Docker/云端部署等，支持 Claude Desktop、Gemini CLI、 Gemini/OpenRouter 等 MCP 客户端接入。
  • 健康检查与统计：提供多服务器健康检查、工具统计与端点信息，以便运行时监控与运维。
• 安装步骤
  • 先安装依赖（常见做法：pip install -r requirements.txt，或逐步安装所需库，如 fastmcp、fastapi、uvicorn、httpx、pydantic、bs4 等）。
  • 启动 MCP 服务器（示例方式）：
    • 通过 ASGI 启动方式：uvicorn asgi_app:app --host 0.0.0.0 --port 8000
    • 或直接运行 Python 脚本启动（如 mcp_server_main.py 内的 main()、run_asgi.py 提供了启动入口）。
  • 访问 MCP 服务接口：在浏览器/客户端中指向 http(s)://<你的服务器地址>:8000/mcp/，即可使用 MCP 工具。
• 服务器配置（MCP 客户端连接信息） 下面的配置用于 MCP 客户端连接到该 MCP 服务器的示例注释配置，JSON 格式，描述服务器名称、启动命令及参数等信息。请将其按需交给你的 MCP 客户端使用（客户端只需要知道服务器名称、启动命令及参数，不需要额外的代码实现）。

{ "server_name": "Yargı MCP Server", "command": "uvicorn", "args": [ "asgi_app:app", "--host", "0.0.0.0", "--port", "8000" ], "notes": "使用 UVicorn 启动的 ASGI 服务，暴露 MCP 端点在 /mcp/ 路径。若使用其它入口，请将 app 暴露入口替换为实际可执行的启动命令。" }

• 基本使用方法
  • 连接与请求：MCP 客户端通过 JSON-RPC 向 /mcp/ 端点发送请求，调用不同工具（如 search_yargitay_detailed、get_yargitay_document_markdown 等）来检索判例、获取文档等。
  • 能力与权限：服务端具备会话管理与能力声明，结合 Bearer token、OpenRouter（语义检索）等实现细粒度访问控制与能力展示。
  • 运维与监控：使用 /health、/status、/api/tools 等端点获取健康状态与工具清单，结合日志进行监控与排错。