Hyperspell

Hyperspell MCP Server

python

2

GitHub Stars

python

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You have a Hyperspell-enabled MCP server that exposes Hyperspell-backed capabilities as an MCP interface. It lets you access hyperspell resources through a structured, tool-like interface or, when configured, as resources you can retrieve or list. This makes it easy to integrate Hyperspell features into your MCP client workflows and automate interactions with Hyperspell-powered data.

How to use

Connect with your MCP client to start using the Hyperspell MCP server. You will configure the MCP client to talk to a local or remote server endpoint and choose whether to expose resources as tools or keep them as resources. By default, resources are exposed as tools so most clients can access them without needing explicit resource endpoints.

When you start the server, you will provide a token for authentication and specify whether to expose resources as tools, resources, or both. You can override the collection name to query or add data to a specific collection. In practice, you will set environment variables and run the MCP server command to bring the service online, then configure your MCP client to connect to the server endpoint.

How to install

Prerequisites: ensure you have a runtime for the server you are using (Python for the Hyperspell MCP server in this example). You may also need a tool runner for MCP commands in your environment (the example uses an uv runner). Ensure you have network access to run the needed commands and that you can set environment variables for authentication.

Install the required runner if needed and make sure the executable is available in your PATH. For example, ensure the uv executable is installed and accessible as uv.
Create a configuration that points to the Hyperspell MCP server using the following snippet. Replace placeholders with your actual values.

{
  "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"
      }
    }
  }
}

Additional notes

Optional: to start the inspector for debugging or development purposes, create a .env file with the required tokens and resource settings, then run the inspector using the following command.

uv run mcp dev src/hyperspell_mcp/server.py