Hyperspell MCP

🚀 配置指南

本項目主要用於配置 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": "<應用或用戶令牌>",
        "USE_RESOURCES": "false"
      }
    }
  }
}

使用 inspector

創建一個 .env 文件，內容如下：

HYPERSPELL_TOKEN=...
HYPERSPELL_USE_RESOURCES=true

然後運行以下命令啟動 inspector：

uv run mcp dev src/hyperspell_mcp/server.py