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 的启动。如有任何疑问，请参考相关文档或联系技术支持人员。