配置
HYPERSPELL_TOKEN应该是一个有效的用户或应用程序令牌（有关如何获取用户令牌，请参阅Hyperspell 文档）。有些 MCP 客户端对资源的支持不太好（比如 Claude Desktop），所以我们可以将它们改为工具形式。将
HYPERSPELL_USE_RESOURCES设置为false（默认值），可以将所有内容都显示为工具；设置true，可以将检索单个文档或列表集合显示为资源；或者，如果您希望全部显示，则同时both。可选地，将
HYPERSPELL_COLLECTION设置为要查询并添加数据的集合的名称。如果未设置，则将使用用户的默认集合。
Related MCP server: Hyperbrowser
克劳德桌面
请注意，Claude 需要uv的绝对路径，可以通过which uv找到（通常是~/.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"
}
}
}
}
使用检查器
创建一个包含以下内容的.env文件：
HYPERSPELL_TOKEN=...
HYPERSPELL_USE_RESOURCES=true
然后运行此命令来启动检查器：
uv run mcp dev src/hyperspell_mcp/server.py