配置指南

• HYPERSPELL_TOKEN 应该是一个有效的用户或应用令牌（参见 Hyperspell 文档 了解如何获取用户令牌）。
• 某些 MCP 客户端不支持资源功能（尤其是 Claude Desktop），因此我们可以将其作为工具来暴露。将 HYPERSPELL_USE_RESOURCES 设为 false（默认值）以将所有内容作为工具暴露，设为 true 以允许检索单个文档或列出集合作为资源，或者设为 both 以同时支持两种方式。
• 可选配置：设置 HYPERSPELL_COLLECTION 为目标查询和添加数据的集合名称。如果未设置，默认会使用用户的默认集合。

Claude Desktop 注意事项

需要注意的是，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"
      }
    }
  }
}

使用 inspector

创建一个 .env 文件，内容如下：

HYPERSPELL_TOKEN=...
HYPERSPELL_USE_RESOURCES=true

然后运行以下命令启动 inspector：

uv run mcp dev src/hyperspell_mcp/server.py