NeoDB MCP Server

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.

NeoDB MCP 서버

소셜 도서 목록 서비스인 NeoDB 와 상호 작용하기 위한 메시지 제어 프로토콜(MCP) 서버 구현입니다. 이 서버는 NeoDB API를 통해 사용자 정보를 가져오고, 도서를 검색하고, 자세한 도서 정보를 조회하는 도구를 제공합니다.

설정

UV 설치

먼저 UV 패키지 설치 프로그램을 설치하세요.

지엑스피1

가상 환경 만들기

UV를 사용하여 Python 가상 환경을 만들고 활성화합니다.

uv venv source .venv/bin/activate # On Unix/macOS # or .venv\Scripts\activate # On Windows

종속성 설치

UV를 사용하여 프로젝트 종속성을 설치합니다.

uv pip install .

사용 가능한 도구

서버는 다음과 같은 도구를 제공합니다.

  1. 사용자 정보 가져오기
    • 현재 사용자의 기본 정보를 가져옵니다
    • 매개변수가 필요하지 않습니다
  2. 검색-책
    • 카탈로그에서 항목을 검색합니다
    • 매개변수:
      • query (문자열): 도서에 대한 검색 쿼리
  3. 겟북
    • 특정 책에 대한 자세한 정보를 얻습니다.
    • 매개변수:
      • book_id (문자열): 검색할 책의 ID

Claude Desktop과 함께 사용

액세스 토큰 받기

액세스 토큰을 얻는 방법은 두 가지가 있습니다.

  1. 공식 가이드 사용: 공식 문서 에 따라 액세스 토큰을 얻으세요.
  2. 자동화된 스크립트 사용: 액세스 토큰을 얻는 간단한 방법을 제공하는 neodb-get-access-token 스크립트를 사용할 수 있습니다.

Config claude_desktop_config.json 업데이트

{ "mcpServers": { "neodb": { "command": "uv", "args": [ "--directory", "<PATH_TO_PROJECT_DIR>", "run", "<PATH_TO_SCRIPT>", "<API_BASE> e.g. https://neodb.social", "<ACCESS_TOKEN>" ] } } }

어디:

  • <API_BASE> : NeoDB API의 기본 URL
  • <ACCESS_TOKEN> : NeoDB API 액세스 토큰

특허

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

-
security - not tested
A
license - permissive license
-
quality - not tested

API를 통해 사용자 정보 가져오기, 도서 검색, 자세한 도서 정보 검색 등의 도구를 제공하여 소셜 도서 목록 서비스인 NeoDB와의 상호작용을 가능하게 합니다.

  1. Setup
    1. Install UV
    2. Create Virtual Environment
    3. Install Dependencies
  2. Available Tools
    1. Usage with Claude Desktop
      1. Get Access Token
      2. Update Config claude_desktop_config.json
    2. License
      ID: 1any3eeaza