Open Library Subjects MCP Server
Open Library API로 장르/주제별 도서 목록과 영어 책 제목 기반 상세 정보를 가져오는 Python FastMCP 서버입니다. API 키 없이 love, history, science 같은 subject를 입력하거나 The Road Less Traveled 같은 영어 제목을 입력해 도서 데이터를 반환합니다.
기능
search_subject_books- Open Library subject/genre를 입력받습니다.
https://openlibrary.org/subjects/{subject}.json을 호출합니다.- 도서 제목, 저자, 첫 출판 연도, Open Library URL을 반환합니다.
- 기본 반환 개수는 5권이고
limit으로 1~50권까지 조정할 수 있습니다. search_book_by_title- 영어 책 제목을 입력받습니다.
https://openlibrary.org/search.json으로 책을 찾고, work 상세와 editions 정보를 함께 조회합니다.- 제목, 저자, 첫 출판 연도, 설명, subject, 판본 정보를 반환합니다.
- 한국어 번역 제목은 Open Library 검색 품질이 낮아 영어 제목만 받습니다.
GET /health- 서버 상태 확인용 엔드포인트입니다.
POST /mcp- FastMCP HTTP transport 엔드포인트입니다.
로컬 실행
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements-dev.txt
python server.py기본 MCP 엔드포인트:
http://localhost:8000/mcp상태 확인:
curl http://localhost:8000/healthMCP 클라이언트 테스트
서버를 실행한 뒤 다른 터미널에서 실행합니다.
python - <<'PY'
import asyncio
from fastmcp import Client
async def main():
async with Client("http://localhost:8000/mcp") as client:
subject_result = await client.call_tool(
"search_subject_books",
{"subject": "love", "limit": 3},
)
print(subject_result.data)
book_result = await client.call_tool(
"search_book_by_title",
{"title": "The Road Less Traveled", "edition_limit": 3},
)
print(book_result.data)
asyncio.run(main())
PY테스트
source .venv/bin/activate
pytest -q파일 구조
.
├── README.md
├── server.py
├── requirements.txt
├── requirements-dev.txt
└── tests/
└── test_server.py참고
- 인증/API 키가 필요 없는 Open Library API를 사용합니다.
- subject 값은 공백을 underscore로 바꾸고 소문자로 정규화합니다.
- 책 제목 검색은 영어 ASCII 제목만 허용합니다.
- 네트워크/API 오류나 응답 형식 오류는 명확한 예외로 변환합니다.
