構成
HYPERSPELL_TOKEN有効なユーザー トークンまたはアプリ トークンである必要があります (ユーザー トークンを取得する方法については、 Hyperspell のドキュメントを参照してください)。一部のMCPクライアントはリソースを適切にサポートしていません（Claude Desktopなど）。そのため、リソースをツールとして公開することができます。HYPERSPELL_USE_RESOURCES
HYPERSPELL_USE_RESOURCES``false（デフォルト）に設定すると、すべてがツールとして公開されます。truetrue設定すると、単一のドキュメントの取得またはコレクションの一覧がリソースとして公開されます。すべてが必要な場合は、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