VikingDB MCP Server
KashiwaByte/vikingdb-mcp-server
Integração com VikingDB para busca e armazenamento vetorial
Ver no GitHubServidor MCP que integra o VikingDB, banco de dados vetorial de alto desempenho desenvolvido pela ByteDance. Permite armazenar, indexar e buscar informações vetoriais diretamente no Claude através de ferramentas especializadas.
Instalação
npx convez-ai KashiwaByte/vikingdb-mcp-server1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Busca semântica em grandes volumes de dados
- Armazenamento e recuperação de embeddings vetoriais
- RAG (Retrieval-Augmented Generation) com banco vetorial
- Aplicações que exigem busca por similaridade em tempo real
Veredito

MCP server bem estruturado e documentado para integração com VikingDB, solução robusta de banco vetorial. Recomendado para quem já usa ou planeja usar VikingDB em arquiteturas de IA e busca vetorial.
README
A tradução para o português deste README ainda está na fila.
VikingDB MCP server
an mcp server for vikingdb store and search
What is VikingDB
VikingDB is a high-performance vector database developed by ByteDance.
You can easily use it following the doc bellow: https://www.volcengine.com/docs/84313/1254444
Tools
The server implements the following tools:
-
vikingdb-colleciton-intro: introduce the collection of vikingdb
-
vikingdb-index-intro: introduce the index of vikingdb
-
vikingdb-upsert-information: upsert information to vikingdb for later use
-
vikingdb-search-information: searche for information in the VikingDB
Configuration
-
vikingdb_host: The host to use for the VikingDB server.
-
vikingdb_region: The region to use for the VikingDB server.
-
vikingdb_ak: The Access Key to use for the VikingDB server.
-
vikingdb_sk: The Secret Key to use for the VikingDB server.
-
collection_name: The name of the collection to use.
-
index_name: The name of the index to use.
Quickstart
Install
Installing via Smithery
To install VikingDB MCP server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install mcp-server-vikingdb --client claude
Claude Desktop
On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
Development/Unpublished Servers Configuration
{
"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"
]
}
}
}
Published Servers Configuration
{
"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"
]
}
}
}
Development
Building and Publishing
To prepare the package for distribution:
- Sync dependencies and update lockfile:
uv sync
- Build package distributions:
uv build
This will create source and wheel distributions in the dist/ directory.
- Publish to PyPI:
uv publish
Note: You'll need to set PyPI credentials via environment variables or command flags:
- Token:
--tokenorUV_PUBLISH_TOKEN - Or username/password:
--username/UV_PUBLISH_USERNAMEand--password/UV_PUBLISH_PASSWORD
Debugging
Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.
You can launch the MCP Inspector via npm with this command:
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
Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
