Configuration

基本能力

产品定位

hyperspell-mcp 是一个中间件服务，用于桥接 MCP 客户端与 Hyperspell 服务之间的通信。

核心功能

• 支持通过环境变量配置 Hyperspell 访问令牌
• 提供灵活的资源配置选项（工具形式或资源形式）
• 支持指定目标集合或使用默认集合
• 针对 Claude Desktop 等客户端进行了特殊优化

适用场景

• 在 MCP 环境中集成 Hyperspell 服务
• 需要灵活控制资源暴露方式的开发场景
• 针对特定客户端（如 Claude Desktop）的优化实现

工具列表

文档中未明确列出具体工具，但提到了可以根据配置将资源以工具形式暴露。

常见问题

• 需要确保正确配置 Hyperspell 访问令牌
• Claude Desktop 需要知道 uv 的绝对路径
• 资源配置方式需要根据客户端能力进行选择

使用教程

使用依赖

• 需要安装 uv 工具（可通过 which uv 查找安装路径）
• 需要有效的 Hyperspell 用户或应用令牌

安装教程

1. 确保已安装 uv 工具
2. 获取 Hyperspell 访问令牌
3. 配置 MCP 客户端（如 Claude Desktop）的启动参数：

{
  "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"
      }
    }
  }
}

调试方式

1. 创建 .env 文件并配置环境变量：

HYPERSPELL_TOKEN=...
HYPERSPELL_USE_RESOURCES=true

1. 运行以下命令启动调试器：

uv run mcp dev src/hyperspell_mcp/server.py

许可证

None