Hyperspell MCP

🚀 配置指南

本指南将详细介绍如何配置相关参数，以确保系统的正确运行。

配置参数说明

• HYPERSPELL_TOKEN：此参数应为有效的用户或应用令牌。若想了解如何获取用户令牌，可参考 Hyperspell 文档。
• HYPERSPELL_USE_RESOURCES：某些 MCP 客户端（尤其是 Claude Desktop）不支持资源功能，因此可将其作为工具来暴露。该参数有以下取值：
  • 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

步骤 1：创建 .env 文件

创建一个 .env 文件，并添加以下内容：

HYPERSPELL_TOKEN=...
HYPERSPELL_USE_RESOURCES=true

步骤 2：启动 inspector

运行以下命令启动 inspector：

uv run mcp dev src/hyperspell_mcp/server.py

通过以上步骤，你可以完成系统的配置和 inspector 的启动。如有任何疑问，请参考相关文档或联系技术支持人员。