🚀 HDW MCP 服务器 Claude 桌面版安装指南
本指南将详细介绍如何安装 HDW MCP 服务器的 Claude 桌面版，为您提供便捷的使用体验。
🚀 快速开始
按照以下步骤，您可以顺利完成 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
获取 API 凭证
在 app.horizondatawave.ai 注册，即可获取免费的 API Key 和 100 个信用。注册成功后，您将收到 HDW_ACCESS_TOKEN 和 HDW_ACCOUNT_ID。
环境配置
在根目录下创建 .env 文件，内容如下：
HDW_ACCESS_TOKEN=YOUR_HD_W_ACCESS_TOKEN
HDW_ACCOUNT_ID=YOUR_HD_W_ACCOUNT_ID
客户端配置
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
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
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"
}
}
}
}
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 协议。