Layer.ai MCP服务器
一个模型上下文协议（MCP）服务器，用于使用Layer.ai的ai平台生成游戏资产。直接从开发环境中生成精灵、角色、背景和其他2D资源。
人工智能制造-谨慎使用
特性
- 资产生成：使用Layer.ai Forge生成2D游戏资源
- 快速优化：使用Layer.ai Prompt Genie优化提示
- 使用情况跟踪：根据免费等级限制（600个资产）监控使用情况
- 工作空间管理：导出和管理工作区数据
- 资产优化：优化和修改现有资产
- 自动保存：自动将生成的资产保存到项目中
- 错误处理：具有自动重试功能的强大错误处理
- 配额保护：防止超过免费等级限制
安装
先决条件
- Python 3.10+ （MCP兼容性要求）
- Git 用于克隆存储库
- Layer.ai帐户 和API令牌
快速安装（推荐）
# Clone the repository
git clone https://github.com/bahadirbklg/layer-ai-mcp-server.git
cd layer-ai-mcp-server
# Run the installation script
chmod +x install.sh
./install.sh手动安装
# Clone the repository
git clone https://github.com/bahadirbklg/layer-ai-mcp-server.git
cd layer-ai-mcp-server
# Create virtual environment (recommended)
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install --upgrade pip
pip install -r requirements.txt
# Create assets directory
mkdir -p assets
# Set up credentials
python layer-mcp-server/setup.py安装选项
- 生产:
pip install -r requirements.min.txt（仅限核心依赖项） - 发展:
pip install -r requirements.dev.txt（包括测试和剥皮工具） - 满的:
pip install -r requirements.txt（推荐给大多数用户）
验证安装
测试您的安装以确保一切正常：
# Run the installation test
python3 verify-install.py这将检查：
- Python版本兼容性（3.10+）
- 已安装所有必需的依赖项
- 项目文件已到位
- 可以成功导入主服务器
配置
环境变量
创建一个 .env 文件或设置环境变量：
# Required: Your Layer.ai API token
LAYER_API_TOKEN=pat_your_token_here
# Optional: API base URL (defaults to https://api.layer.ai)
LAYER_API_BASE_URL=https://api.layer.ai
# Optional: Usage tracking file (defaults to .layer_usage.json)
LAYER_USAGE_FILE=.layer_usage.json
# Optional: Default save directory (defaults to ./assets)
LAYER_DEFAULT_SAVE_DIR=./assets
# Optional: Default workspace ID
LAYER_WORKSPACE_ID=your_workspace_id获取您的API代币
- 注册地址： Layer.ai
- 转到您的帐户设置
- 生成新的API令牌（从
pat_) - 将令牌复制到您的
.env文件
MCP客户端配置
适用于Kiro IDE
添加到MCP客户端配置中：
{
"mcpServers": {
"layer-ai-comprehensive": {
"command": "python",
"args": ["layer-mcp-server/server.py"],
"env": {
"LAYER_API_TOKEN": "pat_your_token_here",
"LAYER_WORKSPACE_ID": "your_workspace_id"
},
"disabled": false,
"timeout": 180,
"autoApprove": [
"create_asset", "remove_background", "describe_image",
"generate_prompt", "get_workspace_info"
]
}
}
}适用于克劳德桌面
添加到您的Claude Desktop MCP配置文件中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"layer-ai": {
"command": "python",
"args": ["path/to/layer-mcp-server/server.py"],
"env": {
"LAYER_API_TOKEN": "pat_your_token_here",
"LAYER_WORKSPACE_ID": "your_workspace_id"
}
}
}
}用法
可用工具
1. create_asset -生成资产
生成精灵、角色、背景和其他资源。
参数：
prompt（必填）：要生成的资产的描述generation_type（可选）：创建、升级等。width/height（可选）：输出尺寸（默认值：512x512）quality（可选）：低、中、高（默认值：高）transparency（可选）：启用透明背景save_path（可选）：保存资产的本地路径
例子：
{
"prompt": "A cute pixel art character for a platformer game",
"generation_type": "CREATE",
"width": 512,
"height": 512,
"transparency": true,
"save_path": "./sprites/player_character.png"
}2. get_workspace_info -检查状态
获取有关Layer.ai工作区和可用功能的信息。
3. remove_background -背景移除（开发中）
使用AI从现有图像中删除背景。
4. describe_image -图像分析（开发中）
获取AI生成的图像描述。
5. generate_prompt -快速优化（开发中）
使用Layer.ai的Prompt Genie优化您的提示。
使用示例
生成游戏精灵
# Create a transparent character sprite
create_asset(
prompt="fantasy warrior character, pixel art, 64x64, RPG game",
generation_type="CREATE",
width=64,
height=64,
transparency=True,
save_path="./assets/warrior_sprite.png"
)创建可平铺纹理
# Generate seamless stone texture
create_asset(
prompt="medieval stone brick wall, seamless texture",
generation_type="CREATE",
width=256,
height=256,
tileability=True,
save_path="./assets/stone_texture.png"
)项目结构
layer-ai-mcp-server/
├── layer-mcp-server/
│ ├── server.py # Main MCP server
│ ├── auth.py # Authentication & token management
│ ├── setup.py # Interactive credential setup
│ ├── api-docs.md # API documentation
│ ├── mcp-config.md # MCP configuration guide
│ ├── security.md # Security documentation
│ └── pyproject.toml # Package configuration
├── assets/ # Generated assets (auto-created)
├── README.md # Main documentation
├── .gitignore # Git ignore patterns
├── requirements.txt # Core dependencies
├── requirements.min.txt # Minimal dependencies
├── requirements.dev.txt # Development dependencies
├── install.sh # Installation script
├── verify-install.py # Installation verification
├── setup.py # Package setup
└── LICENSE # MIT License问题和Bug跟踪
问题
高优先级
- \[BUG-001\] 复杂资产生成的超时问题（>60秒）
- 状态：已解决（已修复MCP配置中超时180秒的问题） - 解决方案：已添加 "timeout": 180 到MCP服务器配置 - 日期: 2025-08-15
中优先级
- \[特征-001\] 未实现背景删除功能
- 状态：进行中 - 描述: remove_background 工具返回“执行中” - 日期: 2025-08-15
- \[特征-002\] 图像描述功能未实现
- 状态：进行中 - 描述: describe_image 工具返回“执行中” - 日期: 2025-08-15
- \[特征-003\] 未实现提示生成功能
- 状态：进行中 - 描述: generate_prompt 工具返回“执行中” - 日期: 2025-08-15
已知限制
- 免费等级限制：免费套餐每月600笔资产
- 文件大小限制：大型资产（>10MB）的处理速度可能较慢
- 依赖网：Layer.ai API需要稳定的互联网连接
- Python版本：需要Python 3.10+才能完全兼容
功能请求
- 3D资产生成：支持生成3D模型和纹理
- 动画支持：生成精灵动画和序列
- 风格迁移：将艺术风格应用于现有资产
- 批量操作：同时处理多个资产
- 资产版本控制：跟踪和管理不同版本的资产
故障排除
常见问题
“API令牌无效”
- 检查你的
.env文件具有正确的LAYER_API_TOKEN - 确保令牌以开头
pat_ - 验证令牌在您的Layer.ai帐户中是否有效
“超出配额”
- 检查使用情况
get_workspace_info工具 - 您已达到免费等级的600资产限额
- 考虑升级您的Layer.ai计划
“网络错误”
- 检查您的互联网连接
- 验证Layer.ai API是否可访问
- 服务器自动重试失败的请求
“MCP连接问题”
- 确保您正确运行服务器
- 检查MCP客户端配置
- 查看服务器日志以了解详细的错误消息
“超时错误”
- 增加MCP配置中的超时时间：
"timeout": 180 - 复杂资产可能需要30-60秒才能生成
- 检查长时间运行的网络稳定性
“安装错误”
- Python版本：确保你有Python 3.10+(
python3 --version) - 虚拟环境：使用虚拟环境避免冲突
- 权限：在Linux/macOS上，您可能需要
chmod +x install.sh - 依赖项：试试
pip install --upgrade pip安装要求之前 - MCP兼容性：一些较旧的Python版本可能存在MCP兼容性问题
“导入错误”
- 缺少的依赖：运行
pip install -r requirements.txt再次 - 虚拟环境：确保您的虚拟环境已激活
- 路径问题：确保从正确的目录运行
- 令牌管理器：如果token_manager导入失败，请运行安装脚本
问题报告模板
报告新问题时，请使用以下格式：
**[TYPE-###]** Brief description
- **Status**: NEW/IN PROGRESS/RESOLVED
- **Priority**: High/Medium/Low
- **Description**: Detailed description of the issue
- **Steps to Reproduce**:
1. Step one
2. Step two
3. Expected vs actual result
- **Environment**:
- OS: [Windows/macOS/Linux]
- Python version: [3.x.x]
- MCP Client: [Claude Desktop/Other]
- **Date**: YYYY-MM-DD问题类型：
BUG-有东西坏了FEATURE-需要新功能ENHANCEMENT-对现有功能的改进DOCS-文件问题PERFORMANCE-性能问题
安全
此项目使用安全凭据管理：
- AES-256加密：API令牌在静止时加密
- PBKDF2密钥推导：安全密钥生成
- 文件权限：限制访问（600）
- 无版本控制风险：从未提交过证书
许可证
MIT许可证-有关详细信息，请参阅许可证文件。
贡献
- 分叉存储库
- 创建要素分支
- 添加新功能的测试
- 提交拉取请求
链接
______________________________________________________________________
人工智能制造-谨慎使用
开始使用Layer.ai为您的项目生成惊人的资产！