mcp-open-library
MCP Open Library
AI 어시스턴트가 도서 및 저자 정보를 검색할 수 있도록 지원하는 Open Library API용 MCP(Model Context Protocol) 서버입니다.
개요
이 프로젝트는 AI 어시스턴트가 Open Library와 상호 작용할 수 있는 도구를 제공하는 MCP 서버를 구현합니다. 제목으로 도서 정보를 검색하고, 이름으로 저자를 검색하며, Open Library 키를 사용하여 상세 저자 정보를 가져오고, Open Library ID(OLID)를 사용하여 저자 사진 URL을 가져올 수 있습니다. 서버는 도서 및 저자 정보에 대한 구조화된 데이터를 반환합니다.
Related MCP server: bookstore-mcp-server
기능
제목으로 도서 검색: 제목을 사용하여 도서 검색 (
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).ID로 도서 가져오기: 다양한 식별자(ISBN, LCCN, OCLC, OLID)를 사용하여 상세 도서 정보 검색 (
get_book_by_id).
설치
Smithery를 통한 설치
Smithery를 통해 Claude Desktop용 MCP Open Library를 자동으로 설치하려면:
npx -y @smithery/cli install @8enSmith/mcp-open-library --client claude수동 설치
# Clone the repository
git clone https://github.com/8enSmith/mcp-open-library.git
cd mcp-open-library
# Install dependencies
npm install
# Build the project
npm run build사용법
서버 실행
node v22.21.1을 사용 중인지 확인하십시오(최신 버전에서도 작동할 수 있지만, 이 테스트에서는 해당 버전을 사용했습니다).
nvm이 설치되어 있다면nvm use를 실행하십시오.mcp-open-library루트 디렉토리에서npm run build를 실행하십시오.다음으로
npm run inspector를 실행하십시오. 빌드가 완료되면MCP_PROXY_AUTH_TOKEN쿼리 문자열 매개변수가 포함된 URL을 클릭하여 Inspector를 엽니다.Inspector에서 'STDIO' 전송 방식을 선택하십시오.
명령어가 'build/index.js'로 설정되어 있는지 확인하십시오.
Inspector에서 'Connect' 버튼을 클릭하면 서버에 연결됩니다.
오른쪽 상단 메뉴 바에서 'Tools'를 클릭하십시오.
도구를 실행해 보십시오(예: get_book_by_title 클릭).
도서를 검색해 보십시오(예: 제목 상자에 'The Hobbit'을 입력하고 'Run Tool' 클릭). 서버가 도서 상세 정보를 반환합니다.
MCP 클라이언트와 함께 사용
이 서버는 Model Context Protocol을 구현하므로 Claude Desktop과 같은 MCP 호환 AI 어시스턴트나 클라이언트에서 사용할 수 있습니다. 서버는 다음 도구를 제공합니다:
get_book_by_title: 제목으로 도서 정보 검색get_authors_by_name: 이름으로 저자 정보 검색get_author_info: Open Library 저자 키를 사용하여 특정 저자의 상세 정보 가져오기get_author_photo: Open Library 저자 ID(OLID)를 사용하여 저자 사진 URL 가져오기get_book_cover: 특정 식별자(ISBN, OCLC, LCCN, OLID 또는 ID)를 사용하여 도서 표지 이미지 URL 가져오기get_book_by_id: 특정 식별자(ISBN, LCCN, OCLC 또는 OLID)를 사용하여 상세 도서 정보 가져오기
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.jpgget_book_cover 입력 예시:
{
"key": "ISBN",
"value": "9780547928227",
"size": "L"
}get_book_cover 출력 예시:
https://covers.openlibrary.org/b/isbn/9780547928227-L.jpgget_book_cover 도구는 다음 매개변수를 허용합니다:
key: 식별자 유형 (ISBN,OCLC,LCCN,OLID또는ID중 하나)value: 식별자 값size: 선택적 표지 크기 (S는 작게,M은 중간,L은 크게, 기본값은L)
get_book_by_id 입력 예시:
{
"idType": "isbn",
"idValue": "9780547928227"
}get_book_by_id 출력 예시:
{
"title": "The Hobbit",
"authors": [
"J. R. R. Tolkien"
],
"publishers": [
"Houghton Mifflin Harcourt"
],
"publish_date": "October 21, 2012",
"number_of_pages": 300,
"isbn_13": [
"9780547928227"
],
"isbn_10": [
"054792822X"
],
"oclc": [
"794607877"
],
"olid": [
"OL25380781M"
],
"open_library_edition_key": "/books/OL25380781M",
"open_library_work_key": "/works/OL45883W",
"cover_url": "https://covers.openlibrary.org/b/id/8231496-M.jpg",
"info_url": "https://openlibrary.org/books/OL25380781M/The_Hobbit",
"preview_url": "https://archive.org/details/hobbit00tolkien"
}get_book_by_id 도구는 다음 매개변수를 허용합니다:
idType: 식별자 유형 (isbn,lccn,oclc,olid중 하나)idValue: 식별자 값
Claude Desktop에서 이 도구가 사용되는 예시는 다음과 같습니다:
Docker
Docker를 사용하여 이 MCP 서버를 테스트할 수 있습니다. 먼저 다음을 실행하십시오:
docker build -t mcp-open-library .
docker run -p 8080:8080 mcp-open-library그런 다음 Inspector를 통해 Docker 내에서 실행 중인 서버를 테스트할 수 있습니다(예):
npm 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기여
기여를 환영합니다! 자유롭게 풀 리퀘스트를 제출해 주십시오.
감사의 말
Available Tools
7 toolsget_author_infoGet author detailsARead-only
Get detailed information for a specific author using their Open Library Author Key (e.g. OL23919A).
Inputs: author_key (required).
get_author_photoGet author photo URLARead-only
Get the URL for an author's photo using their Open Library Author ID (OLID e.g. OL23919A). Reports when no photo exists rather than returning a URL to a blank placeholder.
Inputs: olid (required).
get_authors_by_nameFind authors by nameARead-only
Search for author information on Open Library. Returns at most limit authors (default 10) together with num_found, the total number of matches; page through them with offset. Each result's key can be passed to get_author_info for that author's full record.
Inputs: name (required), limit, offset.
get_book_by_idGet book by identifierARead-only
Get detailed information about a book using its identifier (ISBN, LCCN, OCLC, OLID).
Inputs: idType (required), idValue (required).
get_book_by_titleFind books by titleARead-only
Search for a book by its title on Open Library. Returns at most limit results (default 10) together with num_found, the total number of matches; page through them with offset. Each result carries best_edition — one edition of the work, with its isbn_13/isbn_10 where Open Library has them, and its edition_key, which can be passed to get_book_by_id as { idType: "olid" } for that edition's full record.
Inputs: title (required), limit, offset.
get_book_coverGet book cover URLARead-only
Get the URL for a book's cover image using a key (ISBN, OCLC, LCCN, OLID, ID) and value. Reports when no cover exists rather than returning a URL to a blank placeholder.
Inputs: key (required), value (required), size.
search_booksSearch booksARead-only
Search Open Library across titles, authors, subjects, places, people, publishers and ISBNs. Provide at least one search criterion: q, title, author, subject, place, person, publisher, isbn; combining several narrows the search. Returns at most limit results (default 10) together with num_found, the total number of matches; page through them with offset. Each result carries best_edition — one edition of the work, with its isbn_13/isbn_10 where Open Library has them, and its edition_key, which can be passed to get_book_by_id as { idType: "olid" } for that edition's full record.
Inputs: q, isbn, sort, limit, +8 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Most tools are clearly separated by resource and action, but get_book_by_title overlaps heavily with search_books since it returns the same result structure and is essentially a subset of the general search. The book/author detail and cover/photo tools are unambiguous.
Naming mostly follows a consistent get_<resource>_by_<qualifier> pattern, e.g. get_book_by_id, get_book_by_title, get_author_photo. search_books breaks the get_ convention but remains readable and predictable alongside the others.
Seven tools is well-scoped for a read-only Open Library server. Each tool addresses a distinct lookup need without the collection feeling bloated or thin.
The surface covers general book search, book lookup by ID/title, author search, author details, author photos, and book covers. Minor gaps exist, such as no direct endpoint for works or edition lists beyond indirection through edition_key, but core reading workflows are covered.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
A Model Context Protocol server for Wix AI tools
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Related MCP Servers
- FlicenseBqualityDmaintenanceA Model Context Protocol server implementation that can be run directly or through Docker, enabling AI assistants to interact with external systems through the MCP standard.2-
- FlicenseNot gradedqualityDmaintenanceAn MCP server that exposes tools for querying a bookstore inventory, allowing AI agents to search and retrieve book information via the Model Context Protocol.1-
- AlicenseNot gradedqualityBmaintenanceAn MCP server that enables searching books and authors, fetching editions, browsing subjects, and resolving cover images from Open Library.267 npm4Apache 2.0
- AlicenseNot gradedqualityCmaintenanceMCP server for Google Books API, enabling volume details, ISBN lookup, and bookshelf access via natural language queries.88 npm1MIT