How do I use Academic MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Academic MCP search for research papers on artificial intelligence in KCI and CiNii" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Academic MCP

한국·일본 학술 데이터베이스를 AI 도구에서 검색할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다.

Claude Desktop, Cursor, Windsurf 등 MCP를 지원하는 AI 도구에서 사용할 수 있습니다.

지원 데이터베이스

Provider	국가	콘텐츠	API 키
KCI	🇰🇷	한국학술지인용색인 (학술논문)	❌ 불필요
OAK	🇰🇷	오픈액세스코리아 (OA 논문)	❌ 불필요
KOSTMA	🇰🇷	한국학자료센터 (고문헌)	❌ 불필요
LOSI	🇰🇷	국회도서관 입법정보	✅ 필요
HGIS	🇰🇷	국사편찬위원회 역사지리정보	✅ 필요
NL	🇰🇷	국립중앙도서관	✅ 필요
CiNii	🇯🇵	일본 학술논문	✅ 필요
KoreanTK	🇰🇷	지식재산 용어사전	✅ 필요
NRICH	🇰🇷	국립문화유산연구원 (일제강점기 문헌)	❌ 불필요
Eyis	🇰🇷	여성사전시관 인물연구	✅ 필요

Note: API 키가 필요한 Provider는 각 기관에서 개별 발급받아야 합니다. 아래 API 키 발급 섹션을 참고하세요.

빠른 시작

1. 설치

git clone https://github.com/your-username/academic-mcp.git cd academic-mcp uv sync

2. 설정

cp .env.example .env # 필요한 API 키 입력 (선택사항) # KCI, OAK, KOSTMA는 키 없이도 사용 가능

3. Claude Desktop 설정

claude_desktop_config.json에 추가:

{ "mcpServers": { "academic-mcp": { "command": "uv", "args": [ "--directory", "/path/to/academic-mcp", "run", "academic-mcp" ] } } }

설정 파일 위치:

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

4. 재시작

Claude Desktop을 완전히 종료 후 다시 시작하면 사용 가능합니다.

환경 변수

.env 파일에서 설정:

# 활성화할 Provider (쉼표 구분) # 키 없이 사용 가능: kci, oak, kostma ENABLED_PROVIDERS=kci,oak,kostma # API 키가 필요한 Provider 추가 시 # ENABLED_PROVIDERS=kci,oak,kostma,losi,cinii # 개별 API 키 (필요한 것만 입력) LOSI_API_KEY=your_losi_key HISTORY_API_KEY=your_history_key DATA_GO_KR_API_KEY=your_data_go_kr_key CINII_API_KEY=your_cinii_key

API 키 발급

Provider	발급처	비고
LOSI	국회도서관 입법정보	회원가입 후 신청
HGIS	국사편찬위원회 HGIS	역사지리정보
NL	국립중앙도서관	공공데이터포털에서도 신청 가능
CiNii	CiNii API 등록	일본 NII 계정 필요
KoreanTK	공공데이터포털	"지식재산 용어사전" 신청
Eyis	공공데이터포털	"여성사전시관 인물연구" 신청

커스터마이징

이 프로젝트는 자유롭게 수정해서 사용할 수 있습니다.

Provider 추가/제거

.env 파일의 ENABLED_PROVIDERS에서 원하는 것만 활성화:

# 예: KCI와 CiNii만 사용 ENABLED_PROVIDERS=kci,cinii

새 Provider 작성

src/academic_mcp/providers/ 폴더에 새 Provider 추가:

from academic_mcp.providers.base import BaseProvider class MyProvider(BaseProvider): name = "my_provider" display_name = "My Custom Provider" async def search(self, query): # 구현 pass

프로젝트 구조

academic-mcp/ ├── src/academic_mcp/ │ ├── __main__.py # 진입점 │ ├── server.py # MCP 서버 설정 │ ├── config.py # 환경 변수 설정 │ ├── models.py # 데이터 모델 │ ├── tools.py # MCP 도구 정의 │ └── providers/ # 데이터베이스별 Provider │ ├── base.py │ ├── kci.py # KCI (OAI-PMH) │ ├── oak.py # OAK (OAI-PMH) │ ├── kostma.py │ ├── losi.py │ ├── hgis.py │ ├── nl.py │ └── cinii.py ├── .env.example └── pyproject.toml

다른 MCP 클라이언트

Claude Desktop 외에도 MCP를 지원하는 도구에서 사용 가능합니다:

Cursor:

// ~/.cursor/mcp.json { "mcpServers": { "academic-mcp": { "command": "uv", "args": ["--directory", "/path/to/academic-mcp", "run", "academic-mcp"] } } }

라이선스

MIT License

Academic MCP

Academic MCP

지원 데이터베이스

빠른 시작

1. 설치

2. 설정

3. Claude Desktop 설정

4. 재시작

환경 변수

API 키 발급

커스터마이징

Provider 추가/제거

새 Provider 작성

프로젝트 구조

다른 MCP 클라이언트

라이선스

관련 프로젝트

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API