YokTez MCP: YÖK Ulusal Tez Merkezi için MCP Sunucusu

YokTez MCP：YÖK Ulusal Tez Merkezi用MCPサーバー

このプロジェクトでは、高等教育評議会（YÖK）のUlusal Tez Merkeziへのアクセスを簡単にするFastMCPサーバーを作成します。これにより、YÖK Tez Merkeziでの論文検索や、論文のPDF内容をMarkdown形式で取得する操作を、Model Context Protocol（MCP）に対応したLLM（大規模言語モデル）アプリケーション（Claude Desktopや5ireなど）や、その他のクライアントからツールとして利用できるようになります。

🎯 主な機能

• YÖK Ulusal Tez Merkeziへのプログラムによるアクセスを実現する、標準的なMCPインターフェース。
• 次の機能を利用できます。
  • 詳細な論文検索： タイトル、著者、指導教員、大学、研究科、学科／専攻、論文の種類、対象年、公開許可の有無、論文番号、テーマ、索引、要旨のテキストなど、さまざまな条件で論文を検索できます。
  • 論文の取得： 特定の論文のPDF内容を、ページ単位で処理されたMarkdown形式で取得できます。
  • メタデータの抽出： 論文の詳細ページから、タイトル、著者、年、要旨などの重要なメタデータを抽出します。
  • PDFの許可状況の確認： アクセスできない論文や公開許可のない論文について、適切な通知を表示します。
• 判決文をLLMが処理しやすいようにMarkdown形式に変換します。
• fastmcp installコマンド（または手動設定）を使って、Claude Desktopアプリと簡単に連携できます。
• YokTez MCPは、Claude Desktop以外の5ireなどのMCPクライアントにも対応しています。

---

🚀 5分で始める（リモートMCP）

✅ インストール不要！すぐに使えます！

🔗 リモートMCPアドレス： https://yoktezmcp.fastmcp.app/mcp

Claude Desktopでの使用方法

1. Claude Desktopを開きます
2. Settings → Connectors → Add Custom Connectorを選択します
3. 情報を入力します：
   • Name： YokTez MCP
   • URL： https://yoktezmcp.fastmcp.app/mcp
4. Addボタンをクリックします
5. すぐに使い始められます！ 🎉

Google Antigravityでの使用方法

1. エージェントセッションを開き、エディターのサイドパネルにある**「…」**ドロップダウンメニューをクリックします
2. MCP Serversを選択します。MCP Storeが開きます
3. 上部のManage MCP Serversボタンをクリックします
4. View raw configをクリックします
5. mcp_config.jsonファイルに次の設定を追加します。

{
  "mcpServers": {
    "yoktez-mcp": {
      "serverUrl": "https://yoktezmcp.fastmcp.app/mcp/",
      "headers": {
        "Content-Type": "application/json"
      }
    }
  }
}

💡 ヒント： リモートMCPを使えば、Python、uvなどをインストールすることなく、Claude DesktopからYÖK Ulusal Tez Merkeziに直接アクセスできます！

---

🚀 Claude以外のモデルで使うための簡単なセットアップ（例：5ire）

このセクションは、YokTez MCPツールを5ireなどのClaude Desktop以外のMCPクライアントで使いたい方向けです。

• Python のインストール： システムに Python 3.11 がインストールされている必要があります。インストール時に「Add Python to PATH」（Python を PATH に追加）オプションを選択してください。こちらから 3.11 をダウンロードできます。
• Git のインストール（Windows）： git をダウンロードして、コンピューターにインストールしてください。「Git for Windows/x64 Setup」をダウンロードしてください。
• uv のインストール：
  • Windows ユーザー（PowerShell）： CMD を開き、次のコードを実行してください：powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  • Mac/Linux ユーザー（ターミナル）： ターミナルを開き、次のコードを実行してください：curl -LsSf https://astral.sh/uv/install.sh | sh
• Microsoft Visual C++ Redistributable（Windows）： 一部の Python パッケージを正しく動作させるために必要です。こちらからダウンロードしてインストールしてください。
• お使いのオペレーティングシステムに適した 5ire MCP クライアントをダウンロードしてインストールしてください。
• 5ire を開きます。Workspace -> Providers メニューから、使用する LLM サービスの API キーを入力してください。
• Tools メニューを開きます。+Local または New と書かれたボタンを押してください。
  • Tool Key: yoktezmcp
  • Name: YokTez MCP
  • Command:

    uvx --from git+https://github.com/saidsurucu/yoktez-mcp yoktez-mcp
    

  • Save ボタンを押して保存してください。

• Tools の下に YokTez MCP が表示されているはずです。カーソルを合わせると右側に表示されるボタンをクリックして有効にしてください（緑色のランプが点灯します）。
• これで YokTez MCP と会話できます。

---

⚙️ Claude Desktop の手動インストール

1. 前提条件： Python、uv、（Windows の場合は）Microsoft Visual C++ Redistributable がシステムにインストールされていることを確認してください。詳しくは、上記の「5ire のインストール」セクションにある該当手順をご覧ください。

2. Claude Desktop の Settings -> Developer -> Edit Config を開きます。

3. 開いた claude_desktop_config.json ファイルの mcpServers の下に追加してください：

   {
     "mcpServers": {
       // ... (varsa diğer sunucularınız) ...
       "YokTez MCP": {
         "command": "uvx",
         "args": [
           "--from", "git+https://github.com/saidsurucu/yoktez-mcp",
           "yoktez-mcp"
         ]
       }
     }
   }
   

4. Claude Desktop を終了して、再起動してください。

---

🧩 MCP の代わりに Skill として使用（Claude in Chrome / Claude Desktop のブラウザー）

サーバーをインストールしたくない場合は、同じ機能を skills/yoktez フォルダー内の Claude skill としても利用できます。Skill はブラウザーで開いている tez.yok.gov.tr タブに JavaScript を挿入して動作するため、Python、uv、MCP サーバーは必要ありません。YÖK では CAPTCHA やログインが必要ないため、Claude in Chrome 拡張機能と Claude Desktop 内蔵ブラウザーの両方で動作します。

Skill でできること：

• キーワード検索（論文名／著者／指導教員／分野／キーワード／要約。最大 3 語、AND／OR 検索）
• 詳細検索：学科コード（複数指定時は結合）、論文名、著者、指導教員、キーワード、要約、論文番号、種別、言語、年、公開許可状況
• 学科名からコードを検索、最近追加された論文を表示
• 指導教員、トルコ語／英語の要約、キーワード、引用文（APA、IEEE、MLA、Chicago、Harvard）
• 論文 PDF をページ範囲を指定してテキストとして読み取り（著者が閲覧を制限している論文では、制限理由を通知します）

インストール（Claude Code）：

git clone https://github.com/saidsurucu/yoktez-mcp && cp -r yoktez-mcp/skills/yoktez ~/.claude/skills/

インストール（Claude Desktop / claude.ai）： skills/yoktez フォルダーを zip ファイルに圧縮し、Settings → Capabilities → Skills からアップロードしてください。

詳しくは skills/yoktez/SKILL.md と skills/yoktez/reference.md をご覧ください。

---

🛠️ 利用可能なツール（MCP Tools）

この FastMCP サーバーは、LLM モデル向けに次のツールを提供します：

• search_yok_tez_detailed：YÖK National Thesis Centerで、さまざまな詳細条件を使用して論文を検索します。

  • パラメーター：thesis_title、author_name、advisor_name、university_name、institute_name、department_name、discipline_name、thesis_number、subject_headings、index_terms、abstract_text、thesis_type、permission_status、thesis_status、language、institute_group、year_start、year_end、page、results_per_page。
  • 戻り値：YokTezSearchResult（ページ分割された論文概要のリスト、検索結果の総数などを含みます）

• get_yok_tez_document_markdown：指定したYÖK論文のPDF内容を、指定されたPDFページに基づいてMarkdown形式で取得します。

  • パラメーター：detail_page_url（論文詳細ページのURL）、page_number（指定するPDFのページ番号）。
  • 戻り値：YokTezDocumentMarkdown（ページのMarkdown内容、総ページ数、メタデータなどを含みます）

📜 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細についてはLICENSEファイルをご覧ください。