Hyperspell MCP

配置

• HYPERSPELL_TOKEN 应该是有效的用户或应用程序令牌（请参阅 Hypercell文档 如何获得用户令牌）。
• 一些MCP客户端不支持资源（看看你，Claude Desktop），所以我们可以将它们作为工具公开。集 HYPERSPELL_USE_RESOURCES 向 false （默认）将所有内容作为工具公开， true 将检索单个文档或列出集合作为资源公开，或 both 如果你想要这一切。
• （可选）设置 HYPERSPELL_COLLECTION 到您要查询和添加数据的集合的名称。如果未设置，它将使用用户的默认集合。

克劳德桌面

请注意，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": "",
        "USE_RESOURCES": "false"
      }
    }
  }
}

使用检查器

创建一个 .env 包含以下内容的文件：

HYPERSPELL_TOKEN=...
HYPERSPELL_USE_RESOURCES=true

然后运行此命令以启动检查器：

uv run mcp dev src/hyperspell_mcp/server.py