内容
# PixelLab MCP 服务器
基于 PixelLab AI API 的 Model Context Protocol (MCP) 服务器，提供高级像素艺术和游戏资产创建工具。
## 🚀 功能特点
- **21+ MCP 工具** - 完整的 PixelLab API 集成
- **角色生成** - 4D 和 8D 像素艺术角色
- **动画支持** - 基于模板和文本驱动的动画
- **地形创建** - 用于无缝 2D 环境的 Wang Tilesets
- **图像生成** - Pixflux 和 Bitforge AI 模型
- **资产旋转** - 角色视角修改
- **骨骼动画** - 高级基于姿势的动画
- **API 文档** - 完整的 LLM 优化 API 参考
## 📋 前置条件
- Node.js 16+
- PixelLab API 密钥（从 [pixellab.ai](https://pixellab.ai) 获取）
- 支持 MCP 的客户端（Cursor，带有 MCP 扩展的 VSCode 等）
## 🛠️ 安装
```bash
npm install
npm run build
```
## ⚙️ 配置
设置您的 PixelLab API 凭证：
```bash
export PIXELLAB_API_KEY="your_api_key_here"
export PIXELLAB_API_BASE_URL="https://api.pixellab.ai/v2"
```
## 🎮 使用
### 可用的 MCP 工具：
#### 角色创建
- `create_character` - 生成具有方向精灵的像素艺术角色
- `get_8direction_character` - 支持 360° 旋转
#### 动画
- `animate_character` - 基于模板的动画（行走、奔跑等）
- `animate_with_text` - 创意文本驱动动画
- `animate_with_skeleton` - 专业基于骨骼的动画
#### 世界构建
- `create_topdown_tileset` - 用于 2D 关卡的 Wang Tilesets
- `create_isometric_tile` - 等距资产
#### 图像生成
- `create_image_pixflux` - 高级像素艺术图像生成
- `create_image_bitforge` - 替代艺术风格生成
#### 实用工具
- `get_api_documentation` - 完整的 LLM API 参考
- `get_balance` - 账户信用和用量监控
## 📁 项目结构
```
src/
├── index.ts # 主要的 MCP 服务器实现
├── pixelLab.ts # PixelLab API 包装器
└── types.ts # TypeScript 定义
build/ # 编译后的 JavaScript 输出
docs/ # 额外文档
```
## 🤝 贡献
该 MCP 服务器是作为一个全面的像素艺术工作流项目的一部分开发的。主要里程碑：
- ✅ **完整的 PixelLab API 集成** - 所有 21 个端点已实现
- ✅ **生产就绪代码** - 错误处理、验证、TypeScript
- ✅ **测试和验证** - 成功完成端到端功能测试
- ✅ **游戏开发工作流** - 下载并组织了 27 个角色精灵
### 架构亮点：
- **强大的错误处理** - 全面的验证和用户反馈
- **TypeScript 实现** - 完整的类型安全性和 IDE 支持
- **MCP 合规性** - 标准模型上下文协议实现
- **可扩展设计** - 轻松添加新的 PixelLab API 端点
## 📞 支持
作为一个全面的 AI 驱动的像素艺术游戏开发解决方案创建。结合了：
- **专业资产创建** - 高质量的 AI 生成像素艺术
- **开发者友好工具** - 直观的 MCP 接口集成
- **游戏资产工作流** - 从创建到下载的完整流程
**为独立游戏开发者提供高级 AI 像素艺术创作工具！** 🎮✨
