Content
# @kangtao/lanhu-developer-mcp
Based on [lanhu-developer-mcp](https://www.npmjs.com/package/lanhu-developer-mcp) v1.0.6, with enhancements to resolve parallel download conflicts and directory configuration issues.
## Improvements over the original version
### 1. Custom Download Directory
Specify the download path for each call using the tool parameter `download_dir`:
```json
{
"project_id": "xxx",
"image_id": "yyy",
"download_dir": "src/assets/MyDesign"
}
```
### 2. Global Default Directory Configuration
Configure the default download directory using CLI parameters or environment variables:
```bash
# CLI parameter
lanhu-developer-mcp --download-dir "src/assets/CustomDir"
# Environment variable
LANHU_DOWNLOAD_DIR=src/assets/CustomDir
```
Priority: tool parameter `download_dir` > CLI `--download-dir` > environment variable `LANHU_DOWNLOAD_DIR` > default value `src/assets/LanHuImgFile`
### 3. Parallel Download Safety
When the target directory already exists, automatically create a directory with a numerical suffix to avoid parallel download conflicts:
```
src/assets/LanHuImgFile/ ← 1st download
src/assets/LanHuImgFile_1/ ← 2nd parallel download
src/assets/LanHuImgFile_2/ ← 3rd parallel download
```
### 4. Dynamic Output Path
- Image reference paths are dynamically generated based on the actual download directory (no longer hardcoded `@/src/assets/LanHuImgFile/`)
- JSON data file names are dynamically generated based on the directory name (e.g., `MyDesign_PageData.json`)
## Installation
```bash
npm install -g @kangtao/lanhu-developer-mcp
```
## Usage
Same as the original version, with additional support for the `--download-dir` parameter:
```bash
# stdio mode (MCP integration)
lanhu-developer-mcp --stdio --token YOUR_TOKEN
# HTTP mode
lanhu-developer-mcp --token YOUR_TOKEN --port 8000 --download-dir src/assets/MyDesign
```
### MCP Configuration Example
```json
{
"mcpServers": {
"lanhu-developer-mcp": {
"command": "npx",
"args": ["-y", "@kangtao/lanhu-developer-mcp", "--stdio"],
"env": {
"LANHU_TOKEN": "<your-lanhu-token>",
"LANHU_DOWNLOAD_DIR": "src/assets/LanHuImgFile"
}
}
}
}
```
## Environment Variables
| Variable | Description | Default Value |
| --- | --- | --- |
| `LANHU_TOKEN` | Lanhu user token | Required |
| `PORT` | HTTP service port | 3333 |
| `LANHU_DOWNLOAD_DIR` | Default image download directory | `src/assets/LanHuImgFile` |
## Available Tools
### get_lanhu_data
Get layout information from Lanhu design drafts.
Parameters:
- `project_id` (string, required): Lanhu project ID
- `image_id` (string, optional): Design draft node ID
- `download_dir` (string, optional): Custom image download directory (relative to project root directory)
## License
MIT