HDW MCP 服务器 Claude 桌面版安装指南

安装方式一：通过 Smithery 自动安装

使用 Smithery 自动安装 HDW MCP Server for Claude Desktop：

npx -y @smithery/cli install @horizondatawave/hdw-mcp-server --client claude

安装方式二：手动克隆仓库（macOS）

打开终端运行以下命令：

# 克隆仓库
git clone https://github.com/horizondatawave/hdw-mcp-server.git

# 切换到项目文件夹
cd hdw-mcp-server

# 安装依赖项
npm install

3. 获取 API 凭证

在 app.horizondatawave.ai 注册以获取免费的 API Key 和 100 个信用。您将收到 HDW_ACCESS_TOKEN 和 HDW_ACCOUNT_ID。

4. 环境配置

创建根目录下的 .env 文件，内容如下：

HDW_ACCESS_TOKEN=YOUR_HD_W_ACCESS_TOKEN
HDW_ACCOUNT_ID=YOUR_HD_W_ACCOUNT_ID

5. 客户端配置

5.1 Claude 桌面版

更新您的 Claude 配置文件（claude_desktop_config.json）：

{
  "mcpServers": {
    "hdw": {
      "command": "npx",
      "args": ["-y","@horizondatawave/mcp"],
      "env": {
        "HDW_ACCESS_TOKEN": "YOUR_HD_W_ACCESS_TOKEN",
        "HDW_ACCOUNT_ID": "YOUR_HD_W_ACCOUNT_ID"
      }
    }
  }
}

配置文件位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

5.2 Cursor

简单方式：
在 Cursor 设置中添加新的 MCP 服务器命令：

env HDW_ACCESS_TOKEN=your-access-token HDW_ACCOUNT_ID=your-account-id node /path/to/your/build/index.js

安全方式：
复制提供的模板 run.template.sh 到新文件（例如 run.sh），更新内容后配置 Cursor 运行：

sh /path/to/your/run.sh

5.3 Windsurf

更新您的 Windsurf 配置文件（windsurf_config.json）：

{
  "mcpServers": {
    "hdw": {
      "command": "npx",
      "args": ["-y","@horizondatawave/mcp"],
      "env": {
        "HDW_ACCESS_TOKEN": "YOUR_HD_W_ACCESS_TOKEN",
        "HDW_ACCOUNT_ID": "YOUR_HD_W_ACCOUNT_ID"
      }
    }
  }
}

6. MCP 客户端示例配置

{
  "mcpServers": {
    "hdw": {
      "command": "npx",
      "args": ["-y","@horizondatawave/mcp"],
      "env": {
        "HDW_ACCESS_TOKEN": "/path/to/your/access/token",
        "HDW_ACCOUNT_ID": "/path/to/your/account/id"
      }
    }
  }
}

许可证

本项目遵守 MIT License 协议。