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 연구데이터 검색 및 메타데이터 상세 정보 조회 도구

주요 기능

#	기능	설명
1	논문 검색	ScienceON에서 키워드로 논문을 검색하고 제목, 저자, 초록, CN번호 제공
2	논문 상세정보	CN번호로 특정 논문의 상세정보, DOI, 키워드, 관련논문 조회
3	특허 검색	ScienceON에서 키워드로 특허를 검색하고 출원인, 출원일, CN번호 제공
4	특허 상세정보	CN번호로 특정 특허의 상세정보, IPC분류, 특허상태 조회
5	특허 인용정보	CN번호로 특허의 인용/피인용 관계 분석
6	보고서 검색	ScienceON에서 키워드로 R&D 보고서를 검색하고 저자, 발행기관, CN번호 제공
7	보고서 상세정보	CN번호로 특정 보고서의 상세정보, 인용논문/특허 조회
8	국가R&D 과제 검색	NTIS에서 키워드로 국가R&D 과제를 검색하고 수행기관, 연구비, 과제번호 제공
9	과학기술 분류코드 추천	연구과제 초록으로 적합한 분류코드를 AI 기반 매칭점수와 함께 추천
10	과제 연관콘텐츠 추천	과제번호로 연관된 논문, 특허, 보고서, 관련과제 추천
11	연구데이터 검색	DataON에서 키워드로 공개 연구데이터를 검색하고 제목, 작성자, svcId 제공
12	연구데이터 상세정보	svcId로 특정 연구데이터의 메타데이터, 포맷, 권리정보 조회

History

버전	날짜	주요 사항
0.3.12b0	2026-03-04	- PyPI 정식 배포 - uvx 설치 방식 지원 - README 업데이트
0.3.12a	2025-11-11	- 버그 수정: get_paper_details 메서드 수정 - 기능 개선: 논문/특허/보고서 상세정보에 ScienceON 웹 링크 추가 - 기능 개선: 특허 검색 결과에 CN 번호 표시 및 안내 문구 추가
0.3.12	2025-11-05	- DataON 연구데이터 및 메타정보 검색 기능 지원 등 총 12종 도구 지원
0.2.10a	2025-10-29	- NTIS API Key 통합 및 내부 프로세스 개선
0.2.10	2025-08-13	- NTIS 과제 검색 도구 기능 지원 - NTIS 과학기술분류 추천 도구 기능 지원 - NTIS 과제 연관콘텐츠 추천 도구 기능 지원 등 총 10종 도구 지원
0.1.7	2025-07-22	- 첫 번째 릴리즈 - ScienceON 의 논문, 특허, 보고서 등 총 7종의 API 사용 지원

데이터 소스

• 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으로만 사용됩니다.

필요한 환경변수

변수명	서비스	설명
SCIENCEON_API_KEY	ScienceON	API 키
SCIENCEON_CLIENT_ID	ScienceON	클라이언트 ID
SCIENCEON_MAC_ADDRESS	ScienceON	MAC 주소 (XX-XX-XX-XX-XX-XX)
NTIS_API_KEY	NTIS	API 키 (모든 NTIS 서비스 공통)
DataON_ResearchData_API_KEY	DataON	연구데이터 검색 API 키
DataON_ResearchDataMetadata_API_KEY	DataON	메타데이터 상세조회 API 키

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

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 - 국가연구데이터플랫폼