VikingDB

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.

Integrations

  • Enables interaction with VikingDB, a high-performance vector database developed by ByteDance, with tools for collection and index management, data upsert, and semantic search operations.

VikingDB MCP 서버

vikingdb 저장 및 검색을 위한 mcp 서버

VikingDB란 무엇인가요?

VikingDB는 ByteDance가 개발한 고성능 벡터 데이터베이스입니다.

아래 문서를 참고하시면 쉽게 사용하실 수 있습니다: https://www.volcengine.com/docs/84313/1254444

도구

서버는 다음 도구를 구현합니다.

  • vikingdb-colleciton-intro: vikingdb 컬렉션을 소개합니다
  • vikingdb-index-intro: vikingdb 인덱스를 소개합니다
  • vikingdb-upsert-information: 나중에 사용할 수 있도록 vikingdb에 정보를 upsert합니다.
  • vikingdb-search-information: VikingDB에서 정보 검색

구성

  • vikingdb_host: VikingDB 서버에 사용할 호스트입니다.
  • vikingdb_region: VikingDB 서버에 사용할 지역입니다.
  • vikingdb_ak: VikingDB 서버에 사용할 액세스 키입니다.
  • vikingdb_sk: VikingDB 서버에 사용할 비밀 키입니다.
  • collection_name: 사용할 컬렉션의 이름입니다.
  • index_name: 사용할 인덱스의 이름입니다.

빠른 시작

설치하다

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 VikingDB MCP 서버를 자동으로 설치하려면:

지엑스피1

클로드 데스크탑

MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

개발/미공개 서버 구성

{ "mcpServers": { "mcp-server-vikingdb": { "command": "uv", "args": [ "--directory", "dir to mcp-server-vikingdb", "run", "mcp-server-vikingdb", "--vikingdb-host", "your host", "--vikingdb-region", "your region", "--vikingdb-ak", "your access key", "--vikingdb-sk", "your secret key", "--collection-name", "your collection name", "--index-name", "your index name" ] } } }

게시된 서버 구성

{ "mcpServers": { "mcp-server-vikingdb": { "command": "uvx", "args": [ "mcp-server-vikingdb", "--vikingdb-host", "your host", "--vikingdb-region", "your region", "--vikingdb-ak", "your access key", "--vikingdb-sk", "your secret key", "--collection-name", "your collection name", "--index-name", "your index name" ] } } }

개발

건축 및 출판

배포를 위해 패키지를 준비하려면:

  1. 종속성 동기화 및 잠금 파일 업데이트:
uv sync
  1. 패키지 배포 빌드:
uv build

이렇게 하면 dist/ 디렉토리에 소스와 휠 배포판이 생성됩니다.

  1. PyPI에 게시:
uv publish

참고: 환경 변수나 명령 플래그를 통해 PyPI 자격 증명을 설정해야 합니다.

  • 토큰: --token 또는 UV_PUBLISH_TOKEN
  • 또는 사용자 이름/비밀번호: --username / UV_PUBLISH_USERNAME--password / UV_PUBLISH_PASSWORD

디버깅

MCP 서버는 stdio를 통해 실행되므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해서는 MCP Inspector 사용을 강력히 권장합니다.

다음 명령을 사용하여 npm 통해 MCP Inspector를 시작할 수 있습니다.

npx @modelcontextprotocol/inspector uv --directory dir_to_mcp_server_vikingdb run mcp-server-vikingdb --vikingdb-host your_host --vikingdb-region your_region --vikingdb-ak your_access_key --vikingdb-sk your_secret_key --collection-name your_collection_name --index-name your_index_name

Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.

-
security - not tested
F
license - not found
-
quality - not tested

vikingdb 저장 및 검색을 위한 mcp 서버입니다.

  1. What is VikingDB
    1. Tools
  2. Configuration
    1. Quickstart
      1. Install
      2. Installing via Smithery
    2. Development
      1. Building and Publishing
      2. Debugging
    ID: ur7xu367b9