Aihub MCP

AIHUB-MCP

模型上下文协议（MCP）服务器，用于检索和查询AI中心的数据集。 AI中心是科学技术信息通信部和韩国智能信息社会振兴院运营的国家AI开发支援平台。 https://www.aihub.or.kr/devsport/apishell/list.do?currMenu=403&topMenu=100

功能

v0.1.0（2025-11-10）

• AIHUB完整数据集列表查询功能
• 查询特定数据集的详细信息
• 基于关键字的数据集搜索功能
• AIHUB数据包查询功能
• 查询特定数据包的详细信息
• 数据集下载方法指南

事前准备

1.AI Hub API密钥发放

1. AI Hub网站 连接
2. 注册和登录会员
3. 开发者支持>API Shell>API密钥发放 从菜单发放API密钥
4. 确认通过电子邮件发送的API密钥

2.要求事项

• Python 3.10或更高版本
• uv（Python包管理工具）

安装和设置

1.克隆或下载存储库

# Git clone
git clone https://github.com/ansua79/aihub-mcp.git
cd aihub-mcp

2.设置环境变量

.env.example 复制文件 .env 创建文件：

cp .env.example .env

.env 打开文件并输入颁发的API密钥：

AIHUB_APIKEY=your-api-key-here

3.安装依赖性

uv sync

或手动：

uv pip install mcp httpx python-dotenv

使用方法

直接在本地运行

cd aihub-mcp
uv run server.py

与Claude Desktop配合使用

修改Claude Desktop的配置文件：

视窗: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "aihub": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/aihub-mcp",
        "run",
        "aihub-mcp-server.py"
      ]
    }
  }
}

注意: /absolute/path/to/aihub-mcp请将更改为实际项目路径。

示例：

• 窗户： C:/Users/YourName/projects/aihub-mcp
• macOS/Linux： /home/username/projects/aihub-mcp

设置后重新启动Claude Desktop时，MCP服务器将自动连接。

提供的工具

1. list_datasets

查看AI Hub上的完整数据集列表。

使用示例:

AI Hub에 어떤 데이터셋이 있어?

2. get_dataset_details

查看特定数据集的详细信息和文件结构。

参数:

• dataset_key （必需）：数据集密钥（编号）

使用示例:

데이터셋 593번의 상세 정보를 알려줘

3. search_datasets

使用关键字搜索数据集。

参数:

• keyword （必需）：搜索关键字

使用示例:

헬스케어 관련 데이터셋을 찾아줘

4. list_data_packages

查看AI Hub上的数据包列表。

使用示例:

데이터패키지 목록을 보여줘

5. get_package_details

查询特定数据包的详细信息。

参数:

• package_key （必需）：数据包密钥（编号）

使用示例:

데이터패키지 1번의 상세 정보를 알려줘

6. get_download_info

提供下载数据集的方法和链接。

参数:

• dataset_key （必需）：数据集密钥（编号）
• file_keys （可选）：文件密钥（默认为“all”）

使用示例:

데이터셋 593번을 다운로드하려면 어떻게 해?

项目结构

aihub-mcp/
├── .env                    # API 키 설정 (git 제외)
├── .env.example           # 환경변수 예시
├── .gitignore
├── README.md
├── pyproject.toml         # 프로젝트 설정
├── uv.lock                # 의존성 잠금 파일
└── aihub-mcp-server.py              # MCP 서버 메인 코드

API端点

此MCP服务器使用以下AI Hub API端点：

• GET /info/dataset.do -数据集列表
• GET /info/{datasetkey}.do -数据集详细信息
• GET /info/datapckage.do -数据包列表
• GET /info/pckage/{datapckagekey}.do -数据包详细信息

故障排除

API密钥错误

ValueError: AIHUB_APIKEY not found

→ .env 请确保在文件中设置了正确的API密钥。

Claude Desktop无法连接

1. 验证设置文件的路径是否为绝对路径
2. 完全退出Claude Desktop后重新启动
3. 在终端 uv run server.py直接运行到以确认错误

网络错误

API 요청 실패: ...

→检查互联网连接和AI Hub API服务器状态。

许可证

这个项目 知识共享署名-非商业4.0国际许可（CC BY-NC 4.0） 以下分发。

• 用于个人/学术/研究/教育目的，允许非商业用途
• 禁止商业使用
• 💼 如果您想要商业使用，则需要单独的许可证。联系我们：\[raezero@kisti.re.kr\]

有关详细信息，请访问 许可证 请参考文件。

KISTI超大型AI研究中心AI平台团队

KISTI的超大AI研究中心于2023年12月成立，KISTI是以生成型巨型语言模型“KONI（KISTI Open Natural Intelligence）”的首发为基础，于2024年3月正式成立的部门。 AI平台团队开发AI模型相关平台技术和Agent服务负责。

支持

如果您有任何问题或疑问，请发送电子邮件（raezero@kisti.re.kr）或 问题请在咨询。

相关链接

• KONI：KISTI开放式神经智能 -KISTI科技信息特化巨型语言生成模型
• KISTI人工智能平台团队 -KISTI超大型AI研究中心AI平台团队
• DOREA：面向文档的推理和探索助手
• SpectraBench -大型语言模型基准测试的智能调度系统
• AI Hub官方网站
• AI Hub API Shell指南