MCP Open Library

👁 Trust Score
👁 Listed on Spark

AI 어시스턴트가 도서 및 저자 정보를 검색할 수 있도록 지원하는 Open Library API용 MCP(Model Context Protocol) 서버입니다.

개요

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

Related MCP server: OpenAI 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

사용법

서버 실행

1. node v22.21.1을 사용 중인지 확인하십시오(최신 버전에서도 작동할 수 있지만, 이 테스트에서는 해당 버전을 사용했습니다). nvm이 설치되어 있다면 nvm use를 실행하십시오.

2. mcp-open-library 루트 디렉토리에서 npm run build를 실행하십시오.

3. 다음으로 npm run inspector를 실행하십시오. 빌드가 완료되면 MCP_PROXY_AUTH_TOKEN 쿼리 문자열 매개변수가 포함된 URL을 클릭하여 Inspector를 엽니다.

4. Inspector에서 'STDIO' 전송 방식을 선택하십시오.

5. 명령어가 'build/index.js'로 설정되어 있는지 확인하십시오.

6. Inspector에서 'Connect' 버튼을 클릭하면 서버에 연결됩니다.

7. 오른쪽 상단 메뉴 바에서 'Tools'를 클릭하십시오.

8. 도구를 실행해 보십시오(예: get_book_by_title 클릭).

9. 도서를 검색해 보십시오(예: 제목 상자에 '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.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)

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

기여

기여를 환영합니다! 자유롭게 풀 리퀘스트를 제출해 주십시오.

감사의 말

• Open Library API

• Model Context Protocol

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• get_author_infoA
• get_author_photoA
• get_authors_by_nameC
• get_book_by_idC
• get_book_by_titleB
• get_book_coverB