hyperspell/hyperspell-mcp
3.2
If you are the rightful owner of hyperspell-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This document provides configuration and usage details for setting up a Model Context Protocol (MCP) server using Hyperspell.
Configuration
HYPERSPELL_TOKENshould be a valid user or app token (refer to the Hyperspell docs for how to obtain a user token).- Some MCP clients don't support resources well (looking at you, Claude Desktop), so we can expose them as tools instead. Set
HYPERSPELL_USE_RESOURCEStofalse(default) to expose everything as tools,trueto expose retrieveing single documents or listing collections as resources instead, orbothif you want it all. - Optionally, set
HYPERSPELL_COLLECTIONto the name of the collection you want to query and add data to. If not set, it will use the user's default collection instead.
Claude Desktop
Note that Claude needs the absolute path to uv, which can be found with which uv (it's usually ~/.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"
}
}
}
}
Using the inspector
Create a .env file with the following contents:
HYPERSPELL_TOKEN=...
HYPERSPELL_USE_RESOURCES=true
Then run this to start the inspector:
uv run mcp dev src/hyperspell_mcp/server.py
