KISTI-MCP v0.3.12b0

KISTI-MCP는 한국과학기술정보연구원(KISTI)에서 서비스하는 다양한 플랫폼의 OpenAPI를 활용할 수 있는 MCP서버입니다. ScienceON, NTIS, DataON의 논문, 특허, 보고서, 국가R&D과제, 연구데이터 관련 API를 활용할 수 있습니다. MCP(Model Context Protocol)를 이용하여 거대언어모델과 KISTI가 제공하는 서비스 간 원활한 통합을 지원합니다.

도구

• ScienceON: 논문 검색 및 상세정보, 특허 검색 및 상세정보/ 인용정보, R&D연구보고서 검색 및 상세검색 도구 제공

• NTIS: 국가R&D 연구과제 검색 및 상세검색, 분류코드 추천 도구

• DataON: 국가R&D 연구데이터 검색 및 메타데이터 상세 정보 조회 도구

주요 기능

History

데이터 소스

• ScienceON: 한국과학기술정보연구원의 통합 과학기술 정보서비스

  • 논문 데이터: SCIE, SCOPUS, 한국과학기술논문 등 99.7% 포함

  • 특허 데이터: 국내외 특허 정보 포함

  • 보고서 데이터: 국가 R&D 보고서, 기술동향 보고서 등

• NTIS: 국가과학기술지식정보서비스

  • 국가R&D 과제: 정부 R&D 사업 및 과제 정보

  • 분류코드 추천: 연구 초록 기반 과학기술 분류 추천

  • 연관 콘텐츠: 과제 관련 논문, 특허, 보고서 추천

• DataON: 국가연구데이터플랫폼

  • 연구데이터: 공공 연구데이터, 데이터셋, AI 모델 등

  • 메타데이터: 데이터셋 상세 정보, DOI, 라이선스 정보

설치

요구사항

• 플랫폼 별 API Key 발급 관련 정보

  • ScienceON - API Key, Client ID, MAC Address

    • https://scienceon.kisti.re.kr/por/oapi/openApi.do 사이트 방문

    • 회원가입 및 로그인

    • API Key 및 Client ID 발급 신청

  • NTIS - API Key

    • https://www.ntis.go.kr/rndopen/api/mng/apiMain.do 사이트 방문

    • 회원가입 및 로그인

    • 데이터활용 > OpenAPI > API 별 활용신청

      • 1. 국가R&D 과제검색 서비스(대국민용) 2021-02-09

      • 2. 과학기술표준분류 추천 서비스(기관용) 2019-12-31

      • 3. 연관콘텐츠 추천 서비스(전체용) 2023-11-27

  • DataON - 서비스 별 API Key

    • https://dataon.kisti.re.kr/openApi/openApiList_R.do 사이트 방문(데이터온 > 서비스 > API 활용 > OpenAPI)

    • 회원가입 및 로그인

    • API 키 발급 (데이터온은 검색 API와 상세조회 API 키 별도 발급 필요)

      • 연구데이터 검색 API 활용신청

      • 연구데이터 메타정보 상세 조회 API 활용신청

• uvx 방식 설치 권장

• 또는 uv 설치 (https://github.com/astral-sh/uv)

  • Python 3.10 이상

• MCP 지원 LLM 클라이언트 설정

  • Claude Desktop

설치 방법

uvx 사용 (권장)

별도 설치 없이 PyPI에서 자동으로 받아 실행:

uvx kisti-mcp

uv 사용 (개발자)

1. 저장소 클론

git clone https://github.com/ansua79/kisti-mcp.git
cd kisti-mcp

2. 의존성 설치

uv sync

설정

환경변수 설정

UVX 방식 설치 시 API 키는 MCP 클라이언트 설정(JSON)의 env 항목에 직접 지정하는 방식을 권장합니다. .env 파일은 로컬 개발(uv run) 시 편의용 fallback으로만 사용됩니다.

필요한 환경변수

참고: 키가 없는 서비스는 자동으로 비활성화되며, 나머지 서비스는 정상 동작합니다.

Claude Desktop 등 MCP 클라이언트에서는 JSON 설정의 env 항목으로 환경변수를 주입합니다. 구체적인 설정 방법은 아래 도구 등록 섹션을 참고하세요.

.env 파일 (로컬 개발용/uv 설치 시)

1. .env.example 파일을 .env로 복사:

cp .env.example .env

2. .env 파일을 편집하여 실제 값으로 변경:

# .env 파일 내용
SCIENCEON_API_KEY=your_actual_api_key
SCIENCEON_CLIENT_ID=your_actual_client_id
SCIENCEON_MAC_ADDRESS=your_actual_mac_address
NTIS_API_KEY=your_ntis_api_key
DataON_ResearchData_API_KEY=your_dataon_search_api_key
DataON_ResearchDataMetadata_API_KEY=your_dataon_detail_api_key

사용법

MCP 서버 실행(동작 확인)

uvx 사용 (가장 간단, 권장)

uvx kisti-mcp

MCP 클라이언트(Claude Desktop 등)에서는 JSON 설정의 env 항목으로 환경변수를 주입합니다. CLI에서 직접 실행할 때는 OS 환경변수를 설정한 후 위 명령을 실행하세요.

uv 사용 (개발자용)

uv run python kisti_mcp.py

프로젝트 루트의 .env 파일을 자동으로 읽습니다.

도구 등록

Claude Desktop(윈도우) 기준 %APPDATA%\Claude\claude_desktop_config.json 파일을 수정합니다.

방법 1: uvx 사용 (권장)

uvx가 자동으로 패키지를 다운로드·실행합니다. API 키는 env 항목에 직접 지정합니다.

{
  "mcpServers": {
    "kisti": {
      "command": "uvx",
      "args": ["kisti-mcp"],
      "env": {
        "SCIENCEON_API_KEY": "your_api_key",
        "SCIENCEON_CLIENT_ID": "your_client_id",
        "SCIENCEON_MAC_ADDRESS": "XX-XX-XX-XX-XX-XX",
        "NTIS_API_KEY": "your_ntis_api_key",
        "DataON_ResearchData_API_KEY": "your_dataon_search_api_key",
        "DataON_ResearchDataMetadata_API_KEY": "your_dataon_detail_api_key"
      }
    }
  }
}

• 키가 없는 서비스는 자동 비활성화되며, 나머지 서비스는 정상 동작합니다.

방법 2: uv run 사용 (개발자용)

저장소를 직접 클론한 경우 사용합니다. 이 방식에서는 프로젝트 루트의 .env 파일을 자동으로 읽습니다.

claude_desktop_config.json의 "kisti" 항목을 아래와 같이 변경하세요:

{
  "mcpServers": {
    "kisti": {
      "command": "uv",
      "args": [
        "--directory", 
        "C:/mcp/kisti-mcp",
        "run",
        "python",
        "kisti_mcp.py"
      ]
    }
  }
}

• --directory 값은 git clone한 로컬 경로로 변경하세요.

클라이언트 재시작

• Claude Desktop 기준

  • 메뉴 > 파일 > 종료

  • 또는 작업관리자에서 종료후

• 재시작

  • 검색 및 도구 : kisti ⑫ 확인

도구 사용

Claude Desktop 등의 MCP 클라이언트에서 kisti-mcp 가 정상 등록되었다면, 다음과 같이 사용하실 수 있습니다.

일반 : 인공지능 멀티모달 관련 논문 5개 찾아 요약해줘
명시 : ScienceOn에서 인공지능 멀티모달 논문 검색해줘

검색 결과 예시

논문 검색 결과

🔍 **'인공지능' 논문 검색 결과** (총 1,234건 중 5건 표시):

📄 **Deep Learning for Natural Language Processing**
👤 저자: 김철수, 이영희
📅 연도: 2024
📖 저널: IEEE Transactions on Neural Networks
🔗 논문번호(CN): JAKO202412345678901
📝 초록: 자연어 처리를 위한 딥러닝 기법에 관한 연구...

💡 특정 논문의 상세정보를 원하면 CN번호를 이용해 논문상세보기를 사용하세요.

특허 상세 정보

📋 **특허 상세정보 (CN: KIPO202412345678901)**

🏛️ **특허제목**: 인공지능 기반 음성인식 시스템
👥 **출원인**: 삼성전자
📅 **출원일**: 2024-01-15
📰 **공개일**: 2024-07-15
📊 **특허상태**: 등록
🏷️ **IPC분류**: G10L15/08

프로젝트 구조

kisti-mcp/
├── kisti_mcp.py                          # 메인 서버 파일
├── pyproject.toml                        # 프로젝트 설정
├── claude_desktop_config.json.example    # Claude Desktop 설정 예시 (env 주입 방식)
├── .env.example                          # 환경변수 예시 파일 (개발용 fallback)
├── README.md                             # 이 파일
├── LICENSE                               # 라이선스
└── .gitignore                            # Git 무시 파일

라이선스

이 프로젝트는 Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0) 하에 배포됩니다.

• ✅ 개인적/학술/연구/교육 목적 사용, 비상업적 사용 허용

• ❌ 상업적 사용 금지

• 💼 상업적 사용을 원하시는 경우 별도 라이선스가 필요합니다. 문의: [raezero@kisti.re.kr]

자세한 내용은 LICENSE 파일을 참조하세요.

문제 해결

일반적인 문제

ScienceON

1. 토큰 발급 실패

   • API 키와 클라이언트 ID가 올바른지 확인

   • MAC 주소가 정확한지 확인 (형식: XX-XX-XX-XX-XX-XX)

   • 네트워크 연결 상태 확인

2. 검색 결과 없음

   • 검색 키워드를 다양하게 시도

   • 한글 키워드 사용 권장

NTIS

1. API 키 오류

   • NTIS_API_KEY가 올바르게 설정되었는지 확인

   • 모든 NTIS 서비스에 동일한 API 키 사용

2. 분류코드 추천 실패

   • 연구 초록이 최소 128바이트 이상인지 확인

   • 분류체계 이름이 정확한지 확인

DataON

1. API 키 오류

   • 검색 API와 상세조회 API 키가 각각 올바르게 설정되었는지 확인

   • DataON_ResearchData_API_KEY와 DataON_ResearchDataMetadata_API_KEY 확인

공통

1. 환경변수 확인

   • MCP 클라이언트 JSON 설정의 env 항목에 필요한 키가 올바르게 설정되었는지 확인

   • 환경변수 값에 따옴표나 공백이 없는지 확인

   • 로컬 개발 시 .env 파일을 사용하는 경우, 프로젝트 루트에 파일이 있는지 확인

KISTI 연구지능화센터

KISTI의 연구지능화센터는 과학기술 지식인프라 ScienceON를 통해 국가 과학기술정보, 연구데이터, 정보분석서비스 및 연구인프라를 연계·융합하여 연구자가 필요로 하는 지식인프라를 한곳에서 제공하는 업무를 수행하고 있습니다.

지원

문제가 있거나 질문이 있으시면 이메일(raezero@kisti.re.kr)을 보내주시거나 Issues에서 문의해주세요.

관련 링크

• DOREA-X

• (OLD) KISTI AI Platform Team (BLUESKY)

• (OLD) DOREA Initial

• SpectraBench - Intelligent Scheduling System for Large Language Model Benchmarking

• ScienceON - 국가 과학기술 지식인프라 플랫폼

• NTIS - 국가과학기술지식정보서비스

• DataON - 국가연구데이터플랫폼