hyperspell-mcp

Configuración

• HYPERSPELL_TOKEN debe ser un token de usuario o aplicación válido (consulte la documentación de Hyperspell para saber cómo obtener un token de usuario).

• Algunos clientes MCP no son compatibles con los recursos (te estoy mirando, Claude Desktop), por lo que podemos exponerlos como herramientas. Establece HYPERSPELL_USE_RESOURCES en false (predeterminado) para exponer todo como herramientas, true para exponer la recuperación de documentos individuales o el listado de colecciones como recursos, o both si lo prefieres todo.

• Opcionalmente, configure HYPERSPELL_COLLECTION con el nombre de la colección que desea consultar y a la que desea agregar datos. Si no se configura, se usará la colección predeterminada del usuario.

Related MCP server: Hyperbrowser

Escritorio de Claude

Tenga en cuenta que Claude necesita la ruta absoluta a uv , que se puede encontrar con which uv (normalmente es ~/.local/bin/uv ).

{
  "mcpServers": {
    "Hyperspell": {
      "command": "/path/to/uv",
      "args": [
        "run",
        "--with",
        "hyperspell",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/path/to/hyperspell_mcp/server.py"
      ],
      "env": {
        "HYPERSPELL_TOKEN": "<app or user token>",
        "USE_RESOURCES": "false"
      }
    }
  }
}

Usando el inspector

Crea un archivo .env con el siguiente contenido:

HYPERSPELL_TOKEN=...
HYPERSPELL_USE_RESOURCES=true

Luego ejecute esto para iniciar el inspector:

uv run mcp dev src/hyperspell_mcp/server.py