IEEE MCP Server

IEEE Xplore Metadata Search API를 감싸 IEEE 논문을 검색하는 MCP 서버입니다. npx로 바로 실행할 수 있도록 TypeScript/Node.js로 작성되었습니다.

제공 도구

| 도구 | 설명 | | --- | --- | | search_articles | 자유 텍스트(키워드/구문)로 논문을 검색합니다. | | search_by_fields | 제목, 저자, 초록, 색인어, 게재지 등 특정 필드로 검색합니다. | | get_article_by_doi | DOI로 단일 논문 메타데이터를 조회합니다. |

세 도구 모두 다음 공통 옵션을 지원합니다.

• content_type — Books, Conferences, Courses, Early Access, Journals, Magazines, Standards
• start_year / end_year — 발행 연도 범위 필터
• open_access — true면 오픈 액세스 논문만
• max_records — 반환 개수 (기본 25, 최대 200)
• start_record — 페이징 시작 위치 (1부터)
• sort_field — article_number | article_title | publication_title
• sort_order — asc | desc

요구 사항

• Node.js 18 이상 (내장 fetch 사용)
• IEEE Xplore API 키 — https://developer.ieee.org/ 에서 발급

참고: 발급 직후 키는 활성화까지 시간이 걸릴 수 있습니다. 호출 시 HTTP 403 Developer Inactive가 나오면 아직 키가 활성화되지 않은 상태이니 IEEE 측 승인/활성화를 기다려야 합니다.

설치 및 빌드

npm install
npm run build

MCP 클라이언트 설정

이 서버는 IEEE_API_KEY 환경 변수로 API 키를 받습니다. mcp.json에 다음과 같이 등록하세요.

로컬 빌드본으로 실행

{
  "mcpServers": {
    "ieee": {
      "command": "node",
      "args": ["/Users/mylumbo/Projects/MCP_IEEE/dist/index.js"],
      "env": {
        "IEEE_API_KEY": "여기에_발급받은_키"
      }
    }
  }
}

npx로 실행

먼저 패키지를 배포(npm publish)했거나 로컬 경로를 지정할 수 있는 경우:

{
  "mcpServers": {
    "ieee": {
      "command": "npx",
      "args": ["-y", "ieee-mcp-server"],
      "env": {
        "IEEE_API_KEY": "여기에_발급받은_키"
      }
    }
  }
}

아직 npm에 배포하지 않았다면, 위 "로컬 빌드본으로 실행" 방식을 쓰거나 npx /Users/mylumbo/Projects/MCP_IEEE처럼 로컬 디렉터리 경로를 args에 지정할 수 있습니다.

로컬에서 직접 실행

IEEE_API_KEY=여기에_발급받은_키 node dist/index.js

정상적으로 기동되면 stderr에 [ieee-mcp-server] running on stdio 가 출력되고, stdio로 MCP 요청을 대기합니다.

보안

• API 키는 코드에 하드코딩하지 않고 환경 변수(IEEE_API_KEY)로 주입합니다.
• .env는 .gitignore에 등록되어 커밋되지 않습니다. .env.example을 참고하세요.

사용 예시

MCP 클라이언트에서 도구를 호출하는 인자 예시입니다.

// search_articles
{ "query": "internet of things security", "start_year": 2020, "max_records": 10 }

// search_by_fields
{ "author": "Geoffrey Hinton", "article_title": "deep learning", "content_type": "Journals" }

// get_article_by_doi
{ "doi": "10.1109/5.771073" }

라이선스

MIT