Yokatlas-MCP服务器

Name: Yokatlas-MCP服务器
Author: saidsurucu

作者：saidsurucu53 星标更新：2025-08-05

安装使用来源：spider==github.com

项目介绍

YOKATLAS API MCP Server

此项目，WORKING 提供访问您的数据 yokatlas-py 使用 Python 库 FastMCP 创建服务器。这样，LOKATLAS API 功能、支持模型上下文协议 (MCP) 的大型语言模型 (LLM) 应用程序和其他客户端可以作为工具使用。

🎯 基本特性

用于编程访问 YÖKATLAS 数据的标准 MCP 接口。
引入本科和预科课程的详细信息。
能够对本科和预科课程进行综合搜索（偏好向导）。
与 Claude Desktop 应用程序轻松集成。

📋 先决条件

Python 版本： 您的系统上必须安装 Python 3.12 或更高版本。您可以从 python.org 下载。
pip： 随 Python 安装的包管理器必须运行。

快速安装（推荐）

仅需与 Claude Desktop 集成 uv 您需要安装：

一 `uv` 安装

uv 是一个快速的 Python 包管理器。

macOS 和 Linux：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell)：

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

通过 pip 安装：
```
pip install uv
```

验证我的安装：uv --version

2. 将 Claude 添加到桌面

从 Claude Desktop 设置（设置 > 开发者 > 编辑配置）中，在配置文件中添加以下条目：

{
  "mcpServers": {
    "YOKATLAS API 服务": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/saidsurucu/yokatlas-mcp",
        "yokatlas-mcp"
      ]
    }
  }
}

成功安装后，您可以在 Claude Desktop 应用程序中使用 YOKATLAS API 工具。

</details> <details> <summary>🚀 除了 Claude 之外的模型的简单安装（例如：5ire）</summary>

本节适用于希望在 Claude Desktop 之外使用 YOKATLAS MCP 工具的 MCP 客户端，如 5ire。

Python 安装： 您的系统上必须安装 Python 3.12 或更高版本。安装时务必选择“将 Python 添加到 PATH”选项。您可以在这里下载。
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++ 再发行版（Windows）： 一些 Python 包正常工作所需。在此处下载并安装。
下载并安装适合您操作系统的适当 5ire MCP 客户端。
打开 5ire。工作区 → 提供者 在菜单中输入您要使用的 LLM 服务的 API 密钥。
工具进入菜单。+本地 或新建点击写作按钮。
输入以下信息：
- 工具密钥： yokatlasmcp
- 名称： YOKATLAS MCP
- 命令：
```
uvx --from git+https://github.com/saidsurucu/yokatlas-mcp yokatlas-mcp
```
保存按钮记录。
现在工具下 YOKATLAS MCP 您必须看到他。点击顶部右侧的按钮并激活它（绿灯应亮起）。
您现在可以与 YOKATLAS MCP 对话。

</details> <details> <summary>🔧 使用 Gemini CLI 安装</summary>

视频指南： Gemini CLI MCP 安装视频

先决条件： 确保您的系统上已安装 Python、uv（对于 Windows）Microsoft Visual C++ 再发行版。有关详细信息，请参阅上面的“5ire 安装”部分中的相关步骤。

配置 Gemini CLI 设置：

编辑 Gemini CLI 的配置文件：
- macOS/Linux： ~/.gemini/settings.json
- Windows： %USERPROFILE%\.gemini\settings.json

添加以下 mcpServers 块：

{
  "theme": "Default",
  "selectedAuthType": "oauth-personal",
  "mcpServers": {
    "yokatlas_mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/saidsurucu/yokatlas-mcp",
        "yokatlas-mcp"
      ]
    }
  }
}

配置描述：
- "yokatlas_mcp" 您服务器的本地名称
- "command"：uvx 命令（uv 的包执行工具）
- "args"：直接从 GitHub 运行 YOKATLAS MCP 所需的参数
使用方法：
- 启动 Gemini CLI
- YOKATLAS MCP 车辆将自动可用
- 示例命令：
  - “带来伊斯坦布尔 2024 年基准分数的医学系”
  - “搜索博茨佩奇大学计算机工程项目的详细信息”
  - “列出排名在 400-500,000 范围内的 SAY 分数类型的工程专业”

</details>

🛠️ 适用工具（MCP 工具）

此 FastMCP 服务器提供以下工具：

🔍 智能搜索工具

search_bachelor_degree_programs ⭐ 新智能搜索
- 描述： 本科课程的智能搜索（具有模糊匹配）
- 功能：
  - 🧠 模糊匹配： “BOGOZIÇI” → “BOGOZIÇI UNIVERSITY”
  - 🔎 部分匹配： “computer” → 所有计算机课程
  - 📝 用户友好参数： university，program，city
  - ✅ 类型安全验证： 使用 Pydantic 模型
- 参数：
  - university (str)：大学名称（模糊匹配）
  - program (str)：课程名称（部分匹配）
  - city (str)：城市名称
  - score_type (str)：分数类型（SAY，EA，SOZ，DIL）
  - university_type (str)：大学类型（国家，基金会）
  - fee_type (str)：薪酬状态
  - education_type (str)：教学类型
  - results_limit (int)：结果数量（默认：50）
search_associate_degree_programs ⭐ 新智能搜索
- 描述： 预许可课程的智能搜索（具有模糊匹配）
- 功能：
  - 🧠 模糊匹配： “anadolu” → “ANADOLU UNIVERSITY”
  - 🔎 部分匹配： “tourism” → 所有旅游课程
  - 📝 用户友好参数： university，program，city
  - ⚡ TYT 女士系统： 预许可的特殊评分系统
- 参数：
  - university (str)：大学名称（模糊匹配）
  - program (str)：课程名称（部分匹配）
  - city (str)：城市名称
  - university_type (str)：大学类型
  - fee_type (str)：薪酬状态
  - education_type (str)：教学类型
  - results_limit (int)：结果数量（默认：50）

📊 地图详细工具

get_bachelor_degree_atlas_details
- 描述： 从 YOKATLAS 地图中获取特定学位课程的详细信息
- 参数：
  - yop_kodu (str)：课程 YÖP 代码（例如：'102210277'）
  - year (int)：数据年份（例如：2024，2023）
- 恢复的数据：
  - 通用课程信息和统计数据
  - 配额、位置和分数数据
  - 学生的人口分布
  - 教学人员和设施信息
  - 过去的住房趋势
get_associate_degree_atlas_details
- 描述： 从 YOKATLAS 地图中获取特定本科课程的详细信息
- 参数：
  - yop_kodu (str)：课程 YÖP 代码（例如：'120910060'）
  - year (int)：数据年份（例如：2024，2023）
- 恢复的数据：
  - 通用课程信息和统计数据
  - 配额、位置和分数数据
  - 学生的人口分布
  - 教学人员和设施信息
  - 过去的住房趋势

🚀 应用示例

# Claude Desktop 中的使用示例：

# 1. 使用模糊匹配搜索大学
"查找博茨佩奇大学的计算机工程课程"
# → "博茨佩奇" 自动匹配 "BOĞAZİÇİ ÜNİVERSİTESİ"

# 2. 使用部分课程名称搜索
"列出伊斯坦布尔的所有工程课程"
# → 查找以 "工程" 开头的所有课程

# 3. 城市基础搜索
"显示安卡拉州立大学的医学课程"
# → 根据城市、大学类型和课程过滤搜索

# 4. 预许可课程
"查找安纳托利亚大学与旅游相关的预许可课程"
# → 使用模糊匹配 + 部分匹配搜索预许可课程

# 5. 地图详细信息
"获取 2024 年 YÖP 代码为 102210277 的课程详细信息"
# → 获取课程地图详细信息：配额、位置、分数统计

# 6. 查找课程代码并获取地图详细信息
"查找博茨佩奇计算机工程课程，然后获取地图详细信息"
# → 首先通过搜索找到 YÖP 代码，然后获取地图详细信息

📜 许可证

本项目根据 MIT 许可证发布。