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

Exa MCP Server
exa-labs
A
security
A
license
A
quality
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Last updated -
1
1,964
1,697
TypeScript
MIT License
Open-Ledger-MCP-Serverofficial
openledger
-
security
A
license
-
quality
A Model Context Protocol (MCP) server implementation for the OpenLedger API. This server provides structured context to AI models according to the MCP specification.
Last updated -
8
TypeScript
Apache 2.0
MCP Kibela
kj455
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants to search and access information stored in Kibela, supporting note search, retrieval, creation and updating.
Last updated -
6
107
9
TypeScript
MIT License
MCP Outline Server
Vortiago
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants like Claude to interact with Outline document services, supporting document searching, reading, creation, editing, and comment management.
Last updated -
25
19
Python
MIT License

View all related MCP servers

Appeared in Searches

A server for retrieving papers on arXiv

mcp-open-library