内容
# playdate-mcp
> Playdate SDK开发的MCP服务器 — 使AI代理能够构建游戏、运行Playdate模拟器、执行Lua测试和读取项目元数据。
Playdate生态系统中没有等效的工具。这是第一个适用于Playdate的MCP服务器。
## 工具列表
| 工具 | 描述 |
|------|-------------|
| `build_game` | 使用 `pdc` 编译Playdate Lua项目 |
| `run_simulator` | 启动Playdate模拟器，附带 `.pdx` 包 |
| `run_lua_tests` | 执行桌面Lua单元测试（无需模拟器） |
| `get_build_errors` | 重新运行构建并返回结构化的编译错误 |
| `read_pdxinfo` | 读取和解析 `pdxinfo` 元数据文件 |
## 要求
- Node.js 18+
- [Playdate SDK](https://play.date/dev/) 已安装
- `PLAYDATE_SDK_PATH` 环境变量已设置：
```bash
export PLAYDATE_SDK_PATH="${HOME}/Developer/PlaydateSDK"
```
## 安装
### VS Code (`.vscode/mcp.json`)
```json
{
"servers": {
"playdate": {
"command": "npx",
"args": ["-y", "@wintermuted/playdate-mcp"],
"env": {
"PLAYDATE_SDK_PATH": "/Users/Shared/Playdate SDK"
}
}
}
}
```
### Claude Desktop (`claude_desktop_config.json`)
```json
{
"mcpServers": {
"playdate": {
"command": "npx",
"args": ["-y", "@wintermuted/playdate-mcp"],
"env": {
"PLAYDATE_SDK_PATH": "/Users/Shared/Playdate SDK"
}
}
}
}
```
## 开发
```bash
npm install
npm run build
node dist/index.js # 启动stdio MCP服务器
```
使用MCP检查器检查：
```bash
npx @modelcontextprotocol/inspector node dist/index.js
```
## 许可证
MIT
## 相关
- [playdate-skills](https://github.com/wintermuted/playdate-skills) — Playdate SDK约定的静态代理技能
