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

YokTez MCP：用于 YÖK 国家论文中心的 MCP 服务

本项目创建了一个 FastMCP 服务，方便访问高等教育委员会（YÖK）国家论文中心。借助该服务，MCP 支持的 LLM（大语言模型）应用（例如 Claude Desktop 或 5ire）及其他客户端可以将搜索 YÖK 论文中心的论文，以及以 Markdown 格式获取论文 PDF 内容作为工具使用。

🎯 核心功能

• 提供标准 MCP 接口，以编程方式访问 YÖK 国家论文中心。
• 具备以下功能：
  • 详细论文搜索： 根据标题、作者、导师、大学、研究所、学科／科学分支、论文类型、年份范围、许可状态、论文编号、主题、索引和摘要文本等多种条件搜索论文。
  • 获取论文文档： 以按 PDF 页面处理的 Markdown 格式，获取指定论文的 PDF 内容。
  • 提取元数据： 从论文详情页面提取标题、作者、年份、摘要等重要元数据。
  • PDF 许可检查： 对无法访问或未获发布许可的论文提供相应通知。
• 将判决文本转换为 Markdown 格式，以便 LLM 更轻松地处理。
• 可通过 Claude Desktop 应用中的 fastmcp install 命令（或手动配置）轻松集成。
• YokTez MCP 也支持 Claude Desktop 以外的 MCP 客户端，例如 5ire。

---

🚀 5 分钟快速开始（远程 MCP）

✅ 无需安装！立即使用！

🔗 远程 MCP 地址： https://yoktezmcp.fastmcp.app/mcp

在 Claude Desktop 中使用

1. 打开 Claude Desktop
2. 设置 → 连接器 → 添加自定义连接器
3. 填写信息：
   • 名称： YokTez MCP
   • URL： https://yoktezmcp.fastmcp.app/mcp
4. 点击 添加 按钮
5. 立即开始使用！ 🎉

在 Google Antigravity 中使用

1. 打开 Agent 会话，点击编辑器侧边栏中的 “…” 下拉菜单
2. 选择 MCP 服务器 选项——MCP Store 将会打开
3. 点击顶部的 管理 MCP 服务器 按钮
4. 点击 查看原始配置 选项
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 国家论文中心！

---

🚀 轻松配置，以便与 Claude 以外的模型搭配使用（示例：用于 5ire）

本节面向希望在 5ire 等 Claude Desktop 以外的 MCP 客户端中使用 YokTez 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。

---

🧩 作为 Skill 而非 MCP 使用（Claude in Chrome / Claude Desktop 浏览器）

对于不想安装服务的用户，同样的功能也以 Claude skill 的形式提供，位于 skills/yoktez 文件夹中。该 Skill 通过向浏览器中已打开的 tez.yok.gov.tr 标签页注入 JavaScript 来运行；无需 Python、uv 或 MCP 服务。由于 YÖK 不要求 CAPTCHA 或登录，因此既可与 Claude in Chrome 扩展程序配合使用，也可与 Claude Desktop 内置浏览器配合使用。

Skill 的功能：

• 按关键词搜索（论文标题／作者／导师／主题／关键词／摘要；最多 3 个词条，支持与／或）
• 详细搜索：学科代码（可合并多个代码）、论文标题、作者、导师、关键词、摘要、论文编号、类型、语言、年份、许可状态
• 根据学科名称查找代码、最新添加的论文
• 导师、土耳其语／英语摘要、关键词和预设引用格式（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 国家论文中心搜索论文。

  • 参数：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：根据指定的 PDF 页码，以 Markdown 格式获取指定 YÖK 论文的 PDF 内容。

  • 参数：detail_page_url（论文详情页 URL）、page_number（所需的 PDF 页码）。
  • 返回值：YokTezDocumentMarkdown（包含页面的 Markdown 内容、总页数、元数据等）

📜 许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。