🚀 VikingDB MCP 服务器
VikingDB MCP 服务器为 VikingDB 的存储和搜索功能而实现，可助力用户更高效地利用 VikingDB 进行数据操作。
🚀 快速开始
什么是 VikingDB
VikingDB 是由字节跳动开发的一款高性能向量数据库。您可依照以下文档轻松使用它： https://www.volcengine.com/docs/84313/1254444
工具
该服务器实现了以下工具：
- vikingdb-collection-intro：介绍 VikingDB 的集合
- vikingdb-index-intro：介绍 VikingDB 的索引
- vikingdb-upsert-information：将信息插入到 VikingDB 以备后用
- vikingdb-search-information：在 VikingDB 中搜索信息
配置
| 属性 | 详情 |
|---|---|
| vikingdb_host | 用于 VikingDB 服务器的主机。 |
| vikingdb_region | 用于 VikingDB 服务器的区域。 |
| vikingdb_ak | 用于 VikingDB 服务器的访问密钥。 |
| vikingdb_sk | 用于 VikingDB 服务器的秘密密钥。 |
| collection_name | 要使用的集合名称。 |
| index_name | 要使用的索引名称。 |
安装
使用 Smithery 安装
通过 Smithery 可自动安装 VikingDB MCP 服务器以供 Claude Desktop 使用：
npx @smithery/cli install mcp-server-vikingdb --client claude
Claude Desktop
- MacOS：
~/Library/Application\ 支持/Claude/claude_desktop_config.json - Windows：%APPDATA%/Claude/claude_desktop_config.json%
开发/未发布的服务器配置
{
"mcpServers": {
"mcp-server-vikingdb": {
"command": "uv",
"args": [
"--directory",
"mcp-server-vikingdb 所在的目录",
"run",
"mcp-server-vikingdb",
"--vikingdb-host",
"你的主机",
"--vikingdb-region",
"你的区域",
"--vikingdb-ak",
"你的访问密钥",
"--vikingdb-sk",
"你的秘密密钥",
"--collection-name",
"你的集合名称",
"--index-name",
"你的索引名称"
]
}
}
}
已发布的服务器配置
{
"mcpServers": {
"mcp-server-vikingdb": {
"command": "uvx",
"args": [
"mcp-server-vikingdb",
"--vikingdb-host",
"你的主机",
"--vikingdb-region",
"你的区域",
"--vikingdb-ak",
"你的访问密钥",
"--vikingdb-sk",
"你的秘密密钥",
"--collection-name",
"你的集合名称",
"--index-name",
"你的索引名称"
]
}
}
}
🔧 技术细节
开发
构建和发布
为了准备分发包，可按以下步骤操作：
- 同步依赖项并更新锁定文件：
uv sync
- 构建分发包：
uv build
这将在 dist/ 目录下创建源代码和轮式发行版。
- 发布到 PyPI：
uv publish
注意：您需要通过环境变量或命令行参数设置 PyPI 凭据：
- 令牌：
--token或UV_PUBLISH_TOKEN - 或者用户名/密码：
--username/UV_PUBLISH_USERNAME和--password/UV_PUBLISH_PASSWORD
调试
由于 MCP 服务器通过 stdio 运行，调试可能会很困难。为了获得最佳的调试体验，我们强烈推荐使用 MCP Inspector。 您可以通过以下命令启动 MCP Inspector：
npx @modelcontextprotocol/inspector uv --directory mcp_server_vikingdb 所在的目录 run mcp-server-vikingdb --vikingdb-host 你的主机 --vikingdb-region 你的区域 --vikingdb-ak 你的访问密钥 --vikingdb-sk 你的秘密密钥 --collection-name 你的集合名称 --index-name 你的索引名称
启动后，Inspector 会显示一个 URL，您可以在浏览器中打开该 URL 开始调试。