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.
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