PICO-8 MCP Server

PICO-8 MCP服务器

用于处理PICO-8游戏车的MCP服务器，构建在 神社8.

特性

代码分析工具

• count_tokes -计数标记、字符和压缩大小
• 分析艺术 -列出函数、全局变量和代码度量
• validate_cart -使用令牌限制和linting验证购物车
• 搜索代码 -在购物车中搜索代码模式
• 比较购物车 -比较两个购物车版本的差异

推车操作

• read_cart -阅读购物车部分（代码、gfx、地图、sfx、音乐）
• 迷你购物车 -缩小购物车以减少代币数量
• list_carts -列出包含元数据的目录中的所有购物车

文献资源

• add_文档 -从URL获取并保存PICO-8文档
• 资源 -保存的文档作为MCP资源可用（例如。， pico8://docs/api)

安装

先决条件

• Python 3.8+
• 紫外线 包管理器

设置

1. 克隆存储库：

git clone https://github.com/YOUR_USERNAME/pico8-mcp-server.git
cd pico8-mcp-server

1. 初始化shrinko8子模块：

git submodule update --init --recursive

1. 安装依赖项：

uv sync

克劳德代码（VSCode）

使用Claude CLI添加服务器：

cd /Users/ebonura/Desktop/repos/pico8-mcp-server
claude mcp add pico8 --scope project -- uv run server.py

或者手动创建 .mcp.json 在项目根目录中：

{
  "mcpServers": {
    "pico8": {
      "command": "uv",
      "args": ["run", "/Users/ebonura/Desktop/repos/pico8-mcp-server/server.py"]
    }
  }
}

适用于克劳德桌面

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "pico8": {
      "command": "uv",
      "args": ["--directory", "/Users/ebonura/Desktop/repos/pico8-mcp-server", "run", "server.py"]
    }
  }
}

用法示例

配置后，您可以询问Claude：

• “数一数我地平线滑翔车里的代币”
• “分析v0.16.p8的代码结构”
• “在我的购物车中搜索‘地形’的所有用途”
• “比较v0.15.p8和v0.16.p8”
• “列出地平线滑翔目录中的所有推车”
• “验证我的购物车并显示任何错误”

添加文档

您可以获取并保存PICO-8文档：

"Fetch the PICO-8 API reference from https://pico-8.fandom.com/wiki/APIReference
and save it as 'api'"

保存后，Claude在帮助处理PICO-8代码时可以自动参考文档。

许可证

MIT（继承自shrinko8）