VikingDB

Servidor MCP de VikingDB

un servidor mcp para el almacenamiento y búsqueda en vikingdb

¿Qué es VikingDB?

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

Puedes usarlo fácilmente siguiendo la documentación a continuación: https://www.volcengine.com/docs/84313/1254444

Herramientas

El servidor implementa las siguientes herramientas:

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

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

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

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

Configuración

• vikingdb_host: El host a utilizar para el servidor VikingDB.

• vikingdb_region: La región a utilizar para el servidor VikingDB.

• vikingdb_ak: La clave de acceso a utilizar para el servidor VikingDB.

• vikingdb_sk: La clave secreta a 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

Instalación

Instalación mediante Smithery

Para instalar el servidor MCP de VikingDB para Claude Desktop automáticamente mediante Smithery:

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

Claude Desktop

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

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

Configuración de servidores en desarrollo/no 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"
      ]
    }
  }
}

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

Compilación y publicación

Para preparar el paquete para su distribución:

1. Sincroniza las dependencias y actualiza el archivo de bloqueo:

uv sync

2. Compila las distribuciones del paquete:

uv build

Esto creará distribuciones de código fuente y wheel en el directorio dist/.

3. Publica en PyPI:

uv publish

Nota: Necesitarás configurar las credenciales de PyPI mediante variables de entorno o banderas 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 sobre stdio, la depuración puede ser desafiante. Para la mejor experiencia de depuración, recomendamos encarecidamente usar el MCP Inspector.

Puedes lanzar el Inspector MCP mediante 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 lanzarlo, el Inspector mostrará una URL que puedes acceder en tu navegador para comenzar a depurar.