mcp-오픈-라이브러리

MCP 오픈 라이브러리

AI 보조자가 도서 및 저자 정보를 검색할 수 있도록 하는 Open Library API를 위한 MCP(Model Context Protocol) 서버입니다.

개요

이 프로젝트는 AI 비서가 Open Library 와 상호 작용할 수 있는 도구를 제공하는 MCP 서버를 구현합니다. 제목으로 도서 정보를 검색하고, 이름으로 저자를 검색하고, Open Library 키를 사용하여 자세한 저자 정보를 가져오고, Open Library ID(OLID)를 사용하여 저자 사진의 URL을 가져올 수 있습니다. 서버는 도서 및 저자 정보에 대한 구조화된 데이터를 반환합니다.

특징

제목으로 도서 검색 : 제목을 사용하여 도서를 검색합니다( get_book_by_title ).
이름으로 저자 검색 : 저자 이름을 사용하여 저자를 검색합니다( get_authors_by_name ).
저자 세부 정보 가져오기 : Open Library 키( get_author_info )를 사용하여 특정 저자에 대한 자세한 정보를 검색합니다.
저자 사진 가져오기 : Open Library ID(OLID)를 사용하여 저자 사진의 URL을 가져옵니다( get_author_photo ).
책 표지 가져오기 : 다양한 식별자(ISBN, OCLC, LCCN, OLID, ID)를 사용하여 책 표지 이미지의 URL을 가져옵니다( get_book_cover ).

설치

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 MCP Open Library를 자동으로 설치하려면:

지엑스피1

수동 설치

# Clone the repository
git clone https://github.com/your-username/mcp-open-library.git
cd mcp-open-library

# Install dependencies
npm install

# Build the project
npm run build

용법

서버 실행

MCP Inspector를 사용하여 서버를 테스트할 수 있습니다.

npm run inspector

MCP 검사기에 액세스한 다음 도구를 테스트합니다.

대체 텍스트

MCP 클라이언트와 함께 사용

이 서버는 모델 컨텍스트 프로토콜(Model Context Protocol)을 구현하므로 Claude Desktop 과 같은 모든 MCP 호환 AI 어시스턴트 또는 클라이언트에서 사용할 수 있습니다. 이 서버는 다음과 같은 도구를 제공합니다.

get_book_by_title : 제목으로 책 정보 검색
get_authors_by_name : 이름으로 저자 정보 검색
get_author_info : Open Library Author Key를 사용하여 특정 저자에 대한 자세한 정보를 가져옵니다.
get_author_photo : Open Library Author ID(OLID)를 사용하여 작성자 사진의 URL을 가져옵니다.
get_book_cover : 특정 식별자(ISBN, OCLC, LCCN, OLID 또는 ID)를 사용하여 책 표지 이미지의 URL을 가져옵니다.

get_book_by_title 입력 예시:

{
  "title": "The Hobbit"
}

get_book_by_title 출력 예시:

[
  {
    "title": "The Hobbit",
    "authors": [
      "J. R. R. Tolkien"
    ],
    "first_publish_year": 1937,
    "open_library_work_key": "/works/OL45883W",
    "edition_count": 120,
    "cover_url": "https://covers.openlibrary.org/b/id/10581294-M.jpg"
  }
]

get_authors_by_name 입력 예시:

{
  "name": "J.R.R. Tolkien"
}

get_authors_by_name 출력 예시:

[
  {
    "key": "OL26320A",
    "name": "J. R. R. Tolkien",
    "alternate_names": [
      "John Ronald Reuel Tolkien"
    ],
    "birth_date": "3 January 1892",
    "top_work": "The Hobbit",
    "work_count": 648
  }
]

get_author_info 입력 예시:

{
  "author_key": "OL26320A"
}

get_author_info 출력 예시:

{
  "name": "J. R. R. Tolkien",
  "personal_name": "John Ronald Reuel Tolkien",
  "birth_date": "3 January 1892",
  "death_date": "2 September 1973",
  "bio": "John Ronald Reuel Tolkien (1892-1973) was a major scholar of the English language, specializing in Old and Middle English. He served as the Rawlinson and Bosworth Professor of Anglo-Saxon and later the Merton Professor of English Language and Literature at Oxford University.",
  "alternate_names": ["John Ronald Reuel Tolkien"],
  "photos": [6791763],
  "key": "/authors/OL26320A",
  "remote_ids": {
    "viaf": "95218067",
    "wikidata": "Q892"
  },
  "revision": 43,
  "last_modified": {
    "type": "/type/datetime",
    "value": "2023-02-12T05:50:22.881"
  }
}

get_author_photo 입력 예시:

{
  "olid": "OL26320A"
}

get_author_photo 출력 예시:

https://covers.openlibrary.org/a/olid/OL26320A-L.jpg

get_book_cover 입력 예시:

{
  "key": "ISBN",
  "value": "9780547928227",
  "size": "L"
}

get_book_cover 출력 예시:

https://covers.openlibrary.org/b/isbn/9780547928227-L.jpg

get_book_cover 도구는 다음 매개변수를 허용합니다.

key : 식별자 유형( ISBN , OCLC , LCCN , OLID 또는 ID 중 하나)
value : 식별자의 값
size : 선택 가능한 커버 크기 ( S 는 소형, M 은 중형, L 대형, 기본값은 L )

이 도구가 Claude Desktop에서 사용되는 예는 여기에서 볼 수 있습니다.

도커

Docker를 사용하여 이 MCP 서버를 테스트할 수 있습니다. 먼저 다음을 실행하세요.

docker build -t mcp-open-library .
docker run -p 8080:8080 mcp-open-library

그런 다음 검사기를 통해 Docker 내에서 실행되는 서버를 테스트할 수 있습니다.

pnpm run inspector http://localhost:8080

개발

프로젝트 구조

src/index.ts - 메인 서버 구현
src/types.ts - TypeScript 유형 정의
src/index.test.ts - 테스트 모음

사용 가능한 스크립트

npm run build - TypeScript 코드 빌드
npm run watch - 변경 사항을 확인하고 다시 빌드합니다.
npm test - 테스트 모음 실행
npm run format - Prettier로 코드 포맷하기
npm run inspector - 서버에 대해 MCP Inspector 실행

테스트 실행

npm test

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

감사의 말

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

AI 보조자가 도서 정보를 검색할 수 있도록 하는 Open Library API를 위한 MCP(Model Context Protocol) 서버입니다.

Related MCP Servers

OpenAI MCP Server
arthurcolle
-
security
F
license
-
quality
A Model Context Protocol server implementation that enables connection between OpenAI APIs and MCP clients for coding assistance with features like CLI interaction, web API integration, and tool-based architecture.
Last updated -
33
Python
searchAPI-mcp
RmMargt
-
security
A
license
-
quality
A Model Context Protocol (MCP) based search API server that provides standardized access to Google Maps, Google Flights, Google Hotels and other services. This server enables AI assistants to access various search services through a unified interface.
Last updated -
57
Python
MIT License
Lspace MCP Serverofficial
Lspace-io
A
security
F
license
A
quality
An open-source server implementing the Model Context Protocol (MCP) that enables capturing insights from AI sessions and transforming them into persistent, searchable knowledge accessible across tools.
Last updated -
7
5
TypeScript
Google Research MCP
mixelpixx
-
security
A
license
-
quality
Model Context Protocol (MCP) server that provides AI assistants with advanced web research capabilities, including Google search integration, intelligent content extraction, and multi-source synthesis.
Last updated -
52
3
TypeScript
MIT License

View all related MCP servers

mcp-open-library