LCSH MCP Server

LCSH MCP 서버

간단한 API 인터페이스를 통해 미국 의회도서관 주제표(LCSH)에 대한 액세스를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다.

개요

이 MCP 서버는 Claude와 같은 AI 비서가 공개 Suggest2 API를 사용하여 미국 의회도서관 주제명표목(LCSH)을 검색할 수 있도록 지원합니다. LCSH 데이터를 쿼리하고 API의 다양한 응답 형식을 처리할 수 있는 깔끔한 인터페이스를 제공합니다.

설치

옵션 1: PyPI에서 설치(권장)

LCSH MCP 서버를 설치하는 가장 쉬운 방법은 PyPI에서 직접 설치하는 것입니다.

지엑스피1

옵션 2: 소스에서 설치

소스에서 설치를 선호하는 경우:

Claude Desktop 설정

1. 아직 설치하지 않았다면 https://claude.ai/desktop 에서 Claude Desktop을 설치하세요.
2. 위의 설치 방법 중 하나를 사용하여 LCSH MCP 서버를 설치하세요.
3. Claude Desktop을 열고 설정으로 이동합니다.
   • 왼쪽 하단 모서리에 있는 프로필 사진을 클릭하세요
   • 메뉴에서 "설정"을 선택하세요
4. MCP 서버 구성 :
   • 설정 패널에서 "MCP 서버"를 클릭하세요.
   • "서버 추가"를 클릭하세요
   • 다음 세부 정보를 입력하세요.
     • 이름 : LCSH Search
     • 명령어 : lcsh-mcp-server
   • "저장"을 클릭하세요
5. 서버 활성화 :
   • LCSH 검색 서버 옆에 있는 스위치를 토글하여 활성화합니다.
   • 이제 Claude는 LCSH 검색 기능에 액세스할 수 있습니다.

Claude와 함께 LCSH MCP 서버 사용

Claude Desktop에서 서버를 설정하고 활성화하면 Claude에게 미국 의회 도서관 주제 표목을 검색해 달라고 요청할 수 있습니다. 다음은 몇 가지 프롬프트 예시입니다.

• "미국 의회도서관 주제표에서 '인공지능'을 검색할 수 있나요?"
• "LCSH에서 '기후 변화'를 검색해서 공식 과목명을 알려주세요."
• "양자 컴퓨팅과 관련된 LCSH 용어는 무엇인가요?"

클로드는 MCP 서버를 사용하여 LCSH 데이터베이스에 쿼리를 보내고 결과를 반환합니다.

특징

• MCP 도구 통합 : AI 어시스턴트가 사용할 수 있는 search_lcsh 도구를 공개합니다.
• 리소스 엔드포인트 : lcsh://search/{query} 에서 리소스 엔드포인트를 제공합니다.
• 강력한 오류 처리 : API 오류, 연결 문제 및 예상치 못한 응답 형식을 우아하게 처리합니다.
• 다중 응답 형식 : LCSH API의 사전(히트) 및 목록 응답 형식을 모두 지원합니다.

문제 해결

MCP 서버에 문제가 발생하는 경우:

1. 서버 상태 확인 : Claude Desktop에서 설정 > MCP 서버로 이동하여 서버가 활성화되어 실행 중인지 확인하세요.
2. 서버 재시작 : 서버를 껐다가 다시 켜세요.
3. 콘솔 출력 확인 : 서버를 수동으로 실행하는 경우 콘솔 출력에서 오류 메시지를 확인하세요.
4. 네트워크 연결 확인 : LCSH API에 액세스하려면 컴퓨터에 활성 인터넷 연결이 있는지 확인하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

개발자를 위한

서버 구현, API 참조 및 테스트 정보에 대한 자세한 내용은 references.md 파일을 참조하세요.