VikingDB MCP server

1[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/kashiwabyte-vikingdb-mcp-server-badge.jpg)](https://mseep.ai/app/kashiwabyte-vikingdb-mcp-server)
2 
3# VikingDB MCP server
4[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/KashiwaByte/vikingdb-mcp-server)](https://archestra.ai/mcp-catalog/kashiwabyte__vikingdb-mcp-server)
5 
6[![smithery badge](https://smithery.ai/badge/mcp-server-vikingdb)](https://smithery.ai/server/mcp-server-vikingdb)
7an mcp server for vikingdb store and search
8 
9## What is VikingDB
10VikingDB is a high-performance vector database developed by ByteDance. 
11 
12You can easily use it following the doc bellow:
13https://www.volcengine.com/docs/84313/1254444
14 
15 
16 
17### Tools
18 
19The server implements the following tools:
20 
21- vikingdb-colleciton-intro: introduce the collection of vikingdb
22 
23- vikingdb-index-intro: introduce the index of vikingdb
24 
25- vikingdb-upsert-information: upsert information to vikingdb for later use
26 
27- vikingdb-search-information: searche for information in the VikingDB
28  
29  
30## Configuration
31 
32- vikingdb_host: The host to use for the VikingDB server.
33 
34- vikingdb_region: The region to use for the VikingDB server.
35 
36 - vikingdb_ak: The Access Key to use for the VikingDB server.
37 
38 - vikingdb_sk: The Secret Key to use for the VikingDB server.
39 
40- collection_name: The name of the collection to use.
41 
42- index_name: The name of the index to use.
43 
44 
45## Quickstart
46 
47### Install
48 
49### Installing via Smithery
50 
51To install VikingDB MCP server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/mcp-server-vikingdb):
52 
53```bash
54npx -y @smithery/cli install mcp-server-vikingdb --client claude
55```
56 
57#### Claude Desktop
58 
59On MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
60 
61On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
62 
63 
64Development/Unpublished Servers Configuration
65```
66{
67  "mcpServers": {
68    "mcp-server-vikingdb": {
69      "command": "uv",
70      "args": [
71        "--directory",
72        "dir to mcp-server-vikingdb",
73        "run",
74        "mcp-server-vikingdb",
75        "--vikingdb-host", 
76        "your host",
77        "--vikingdb-region", 
78        "your region",
79        "--vikingdb-ak", 
80        "your access key",
81        "--vikingdb-sk", 
82        "your secret key",
83        "--collection-name",
84        "your collection name",
85        "--index-name",
86        "your index name"
87      ]
88    }
89  }
90}
91 
92  ```
93 
94Published Servers Configuration
95  ```
96{
97    "mcpServers": {
98      "mcp-server-vikingdb": {
99        "command": "uvx",
100        "args": [
101          "mcp-server-vikingdb",
102          "--vikingdb-host", 
103          "your host",
104          "--vikingdb-region", 
105          "your region",
106          "--vikingdb-ak", 
107          "your access key",
108          "--vikingdb-sk", 
109          "your secret key",
110          "--collection-name",
111          "your collection name",
112          "--index-name",
113          "your index name"
114      ]
115     }
116    }
117  } 
118  ```
119 
120 
121## Development
122 
123### Building and Publishing
124 
125To prepare the package for distribution:
126 
1271. Sync dependencies and update lockfile:
128```bash
129uv sync
130```
131 
1322. Build package distributions:
133```bash
134uv build
135```
136 
137This will create source and wheel distributions in the `dist/` directory.
138 
1393. Publish to PyPI:
140```bash
141uv publish
142```
143 
144Note: You'll need to set PyPI credentials via environment variables or command flags:
145- Token: `--token` or `UV_PUBLISH_TOKEN`
146- Or username/password: `--username`/`UV_PUBLISH_USERNAME` and `--password`/`UV_PUBLISH_PASSWORD`
147 
148### Debugging
149 
150Since MCP servers run over stdio, debugging can be challenging. For the best debugging
151experience, we strongly recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector).
152 
153 
154You can launch the MCP Inspector via [`npm`](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) with this command:
155 
156```bash
157npx @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
158```
159 
160 
161Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
162