Skip to main content
Glama
KashiwaByte

VikingDB

by KashiwaByte

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에서 정보 검색

Related MCP server: mmnt-mcp-server

구성

  • 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이 표시됩니다.

Related MCP Connectors

Related MCP Servers