Na OpenAPI MCP

Install

Works with Claude Desktop. Read the repository before you give any tool access to your data.

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

5 read · 1 write · 0 delete

Secrets

None asked for

Install scripts

Not scanned yet

Runs as

Downloaded binary

Tools (6)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• na_collect

  [수집] 검색어들을 각각 조회해 **합집합**으로 모으고 파일로 저장한다. terms: `검색항목,키워드` 형식의 검색어 목록. 각각 개별 검색 후 **합집합**(OR)으로 병합한다. 이 API 의 `|` 는 AND 이므로 OR 은 이렇게 만들어야 한다. 예: `["전체,교육불평등", "전체,교육격차", "자료명,교육 형평성"]` search: 단일 검색어(terms 대신). ⚠️ `year_from`/`year_to`/`contains` 는 **로컬 후처리**다 — 이미 받은 레코드에만 걸리며 회수 한계를 풀어주지 않는다. 서버측 연도 필터는 **상세검색의 `option`** 뿐이므로 연도로 범위를 좁히려면 `dbname` 과 함께 `option="발행년도,2000|발행년도,2010"` 을 쓸 것. formats: xlsx/csv/json/sqlite (기본 3종). save=false 면 저장 없이 미리보기만. out_dir 미지정 시 홈의 na-output/. 반환 메타의 `cap_hit_terms` 는 회수 한계(99,000건)에 걸린 검색어를, `incomplete_terms` 는 재시도 후에도 실패한 페이지가 있는 검색어를…

• na_detailread-only

  [상세정보] 제어번호 1건의 서지정보를 조회한다. controlno: 검색 결과의 **`제어번호`** (예: `MONO12026000012887`, `KINX2026037525`). 🔴 **검색 결과(`na_search` 의 raw)와 필드 집합·값이 완전히 동일하다** — ✅ 실측 (일반도서 19 · 학위논문 18 · 국내기사 13 · 고서 19 · 웹자료 17개 전부 상세전용 필드 0). 즉 **이미 검색한 자료라면 이 도구를 부를 이유가 없다.** 쿼터(10,000건/일)만 쓴다. 쓸 자리는 **제어번호만 아는 자료를 조회할 때**다. 목차 본문이 필요하면 `na_toc` 를 쓸 것 (그쪽은 검색에 없는 내용을 실제로 준다). ⚠️ **존재하지 않는 제어번호도 `ERR04` 로 응답한다**(실측) — 전용 '자료 없음' 코드가 없어 일시 오류와 구분되지 않는다. 실패하면 제어번호부터 확인할 것. ⚠️ 별도 활용신청 대상이다(data.go.kr 15098175). 자료검색 키만으로는 접근할 수 없다.

• na_fieldsread-only

  검색항목·dbname 등 이 API 에서 실제로 통하는 값 목록과 실측 근거.

• na_searchread-only

  [자료검색] 국회도서관의 도서·학위논문·국내외 기사 등 목록DB를 검색한다. search: **`검색항목,키워드`** 형식이 필수다(그냥 키워드만 넣으면 오류). `|` 로 여러 개를 연결하면 **AND** 로 묶인다. 예: `전체,교육|자료명,불평등`. OR(합집합)이 필요하면 `na_collect(terms=[…])` 를 쓸 것 — 이 API 에 OR 문법은 없다. **검색항목(통합검색 전용 7종)**: 기본검색 · 전체 · 자료명 · 저자 · 발행자 · 키워드 · 청구기호 🔴 **그 밖의 값을 쓰면 오류가 나지 않고 검색어가 통째로 무시되어 전체 카탈로그 13,097,591건이 반환된다.** 특히 `저자명` 은 상세검색(dbname 지정 시)에서는 유효한 이름이라 헷갈리기 쉽다 — 통합검색에서는 반드시 `저자` 를 쓸 것. 이 도구는 화이트리스트로 미리 막고 오류를 돌려준다. dbname: 지정하면 **상세검색**(`/detail`)으로 전환된다. 21종 중 정확한 문자열이어야 한다: 일반도서 · E-BOOK · 고서 · 세미나자료 · 웹자료 · 학위논문 · 국내기사 · 국외기사 · `학술지,잡지`…

• na_statusread-only

  연결 점검 — 인증키 보유 여부 + 자료검색 API 실제 왕복 1회.

• na_tocread-only

  [목차] 제어번호 1건의 목차정보를 조회한다. controlno: 검색 결과의 **`제어번호`**. ⚠️ 원문은 HTML 이 이스케이프되어 오므로 이 도구가 태그를 풀어 줄바꿈 텍스트로 정리한다. 실제 주력 구분자는 `<p>` 다(실측 10/10) — 계층은 **행 앞 들여쓰기**로 표현되므로 그대로 보존해 돌려준다. ⚠️ **목차가 없는 자료도 정상이다.** 검색 결과의 `목차` 필드가 'Y' 인 자료만 부르면 헛호출과 쿼터 낭비를 줄일 수 있다(개발계정 10,000건/일). 🔴 **다음 자료종은 `목차` 가 전건 'N' 이라 이 도구를 부를 이유가 아예 없다**(census 실측): E-BOOK · 학술지,잡지 · 신문 · 국외기사 · 동영상자료. 🔴 **`목차정보없음` 센티널** — 플래그가 'Y' 인데 본문이 그 말의 반복인 자료가 있다 (고서에서 표본 5/5). 최대 792자라 길이 검사를 통과하므로 이 도구가 걸러 빈 문자열로 돌려주고, 원문은 `envelope.toc_sentinel` 에 남긴다.

Signals

Stars

1

Forks

0

Open issues

1

Last commit

Oct 24, 2026 (5 days ago)

Last release

Sep 7, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.rubatoyd/na-openapi-mcp

Version

0.1.1

Auth

API key

Packages

mcpb https://github.com/rubatoyd/na-openapi-mcp/releases/download/v0.1.1/na-openapi-mcp.mcpb

License

MIT

Repository

github.com/rubatoyd/na-openapi-mcp

Website

github.com/rubatoyd/na-openapi-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql