Servidor MCP de VikingDB

Un servidor mcp para almacenar y buscar en VikingDB

¿Qué es VikingDB?

VikingDB es una base de datos vectorial de alto rendimiento desarrollada por ByteDance.

Puedes usarlo fácilmente siguiendo el siguiente documento: https://www.volcengine.com/docs/84313/1254444

Herramientas

El servidor implementa las siguientes herramientas:

• vikingdb-colleciton-intro: presenta la colección de vikingdb

• vikingdb-index-intro: presenta el índice de vikingdb

• vikingdb-upsert-information: inserta información en vikingdb para su uso posterior

• vikingdb-search-information: busca información en VikingDB

Related MCP server: mmnt-mcp-server

Configuración

• vikingdb_host: El host que se utilizará para el servidor VikingDB.

• vikingdb_region: La región que se utilizará para el servidor VikingDB.

• vikingdb_ak: La clave de acceso que se utilizará para el servidor VikingDB.

• vikingdb_sk: La clave secreta que se utilizará para el servidor VikingDB.

• collection_name: El nombre de la colección a utilizar.

• index_name: El nombre del índice a utilizar.

Inicio rápido

Instalar

Instalación mediante herrería

Para instalar el servidor VikingDB MCP para Claude Desktop automáticamente a través de Smithery :

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

Escritorio de Claude

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

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

Configuración de servidores no publicados/desarrollo

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

Configuración 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"
    ]
   }
  }
} 

Desarrollo

Construcción y publicación

Para preparar el paquete para su distribución:

1. Sincronizar dependencias y actualizar el archivo de bloqueo:

uv sync

2. Distribuciones de paquetes de compilación:

uv build

Esto creará distribuciones de origen y de rueda en el directorio dist/ .

3. Publicar en PyPI:

uv publish

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:

• Token: --token o UV_PUBLISH_TOKEN

• O nombre de usuario/contraseña: --username / UV_PUBLISH_USERNAME y --password / UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con 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

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.