Hyperspell智联数据

配置

• 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": "<app or user token>",
        "USE_RESOURCES": "false"
      }
    }
  }
}

使用检查器

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

HYPERSPELL_TOKEN=...
HYPERSPELL_USE_RESOURCES=true

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

uv run mcp dev src/hyperspell_mcp/server.py