Hyperspell Mcp
What is Hyperspell Mcp
hyperspell-mcp is a server designed to facilitate interactions with the Hyperspell API, allowing users to manage and retrieve collections of documents efficiently.
Use cases
Use cases for hyperspell-mcp include developing applications that require document storage and retrieval, integrating with existing workflows that utilize the Hyperspell API, and creating tools for data analysis.
How to use
To use hyperspell-mcp, set up a valid user or app token in the HYPERSPELL_TOKEN environment variable. Configure the server by specifying whether to use resources or tools, and optionally set the HYPERSPELL_COLLECTION for querying specific collections. Start the server using the provided command structure.
Key features
Key features of hyperspell-mcp include support for document collections, flexible configuration options for resource management, and compatibility with various MCP clients.
Where to use
hyperspell-mcp can be used in fields such as document management, data retrieval, and application development where interaction with the Hyperspell API is required.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Hyperspell Mcp
hyperspell-mcp is a server designed to facilitate interactions with the Hyperspell API, allowing users to manage and retrieve collections of documents efficiently.
Use cases
Use cases for hyperspell-mcp include developing applications that require document storage and retrieval, integrating with existing workflows that utilize the Hyperspell API, and creating tools for data analysis.
How to use
To use hyperspell-mcp, set up a valid user or app token in the HYPERSPELL_TOKEN environment variable. Configure the server by specifying whether to use resources or tools, and optionally set the HYPERSPELL_COLLECTION for querying specific collections. Start the server using the provided command structure.
Key features
Key features of hyperspell-mcp include support for document collections, flexible configuration options for resource management, and compatibility with various MCP clients.
Where to use
hyperspell-mcp can be used in fields such as document management, data retrieval, and application development where interaction with the Hyperspell API is required.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
