hyperspell-mcp

構成

• HYPERSPELL_TOKEN有効なユーザー トークンまたはアプリ トークンである必要があります (ユーザー トークンを取得する方法については、 Hyperspell のドキュメントを参照してください)。

• 一部のMCPクライアントはリソースを適切にサポートしていません（Claude Desktopなど）。そのため、リソースをツールとして公開することができます。HYPERSPELL_USE_RESOURCES HYPERSPELL_USE_RESOURCES``false （デフォルト）に設定すると、すべてがツールとして公開されます。true 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