VikingDB

Servidor MCP VikingDB

um servidor mcp para armazenamento e busca no vikingdb

O que é o VikingDB

O VikingDB é um banco de dados vetorial de alta performance desenvolvido pela ByteDance.

Você pode usá-lo facilmente seguindo a documentação abaixo: https://www.volcengine.com/docs/84313/1254444

Ferramentas

O servidor implementa as seguintes ferramentas:

• vikingdb-colleciton-intro: apresenta a coleção do vikingdb

• vikingdb-index-intro: apresenta o índice do vikingdb

• vikingdb-upsert-information: insere informações no vikingdb para uso posterior

• vikingdb-search-information: busca informações no VikingDB

Configuração

• vikingdb_host: O host a ser usado para o servidor VikingDB.

• vikingdb_region: A região a ser usada para o servidor VikingDB.

• vikingdb_ak: A Chave de Acesso a ser usada para o servidor VikingDB.

• vikingdb_sk: A Chave Secreta a ser usada para o servidor VikingDB.

• collection_name: O nome da coleção a ser usada.

• index_name: O nome do índice a ser usado.

Início Rápido

Instalação

Instalando via Smithery

Para instalar o servidor MCP VikingDB para o Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install mcp-server-vikingdb --client claude

Claude Desktop

No MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

No Windows: %APPDATA%/Claude/claude_desktop_config.json

Configuração de Servidores em Desenvolvimento/Não Publicados

{
  "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"
      ]
    }
  }
}

Configuração de Servidores Publicados

{
  "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"
    ]
   }
  }
} 

Desenvolvimento

Compilação e Publicação

Para preparar o pacote para distribuição:

1. Sincronize as dependências e atualize o arquivo de bloqueio:

uv sync

2. Compile as distribuições do pacote:

uv build

Isso criará distribuições de código-fonte e wheel no diretório dist/.

3. Publique no PyPI:

uv publish

Observação: Você precisará definir as credenciais do PyPI por meio de variáveis de ambiente ou sinalizadores de comando:

• Token: --token ou UV_PUBLISH_TOKEN
• Ou nome de usuário/senha: --username/UV_PUBLISH_USERNAME e --password/UV_PUBLISH_PASSWORD

Depuração

Como os servidores MCP são executados via stdio, a depuração pode ser desafiadora. Para a melhor experiência de depuração, recomendamos fortemente o uso do MCP Inspector.

Você pode iniciar o MCP Inspector via npm com este comando:

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

Ao iniciar, o Inspector exibirá uma URL que você pode acessar no seu navegador para começar a depurar.