Libresprite MCP

🚀 LibreSprite-MCP

LibreSprite-MCP 是一個用於在 LibreSprite 內進行提示輔助編輯、設計和腳本編寫的模型上下文協議（MCP）服務器，能讓你通過提示的方式更好地使用 LibreSprite。

項目演示視頻

🚀 快速開始

📦 安裝指南

推薦使用 uv 來安裝和使用此服務器。如果你還未安裝 uv，可以使用以下快速命令進行安裝：

• Windows：（以管理員身份運行）

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

• Unix：

curl -LsSf https://astral.sh/uv/install.sh | sh

更多關於 安裝 uv 的信息。

該軟件包已發佈在 PyPI 上，你也可以使用其他喜歡的方式（如 pipx 等）來安裝。

💻 使用示例

步驟 1：設置客戶端

將以下入口命令（如果你不使用 uv，可以使用其他命令）添加到你的 MCP 客戶端中：

uvx libresprite-mcp

示例：

• Claude Desktop 和 Cursor 編輯 Claude > 設置 > 開發者 > 編輯配置 > claude_desktop_config.json 或 .cursor > mcp.json，以包含該服務器：

{
    "mcpServers": {
        // ...現有服務器...
        "libresprite": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "libresprite-mcp"
            ]
        }
        // ...現有服務器...
    }
}

你也可以使用這個便捷的徽章來快速完成設置：

⚠️ 重要提示 你需要重啟 Claude Desktop 才能加載 MCP 服務器。

步驟 2：設置 LibreSprite

從 發佈頁面 下載最新的穩定遠程腳本 mcp.js，並將其添加到 LibreSprite 的腳本文件夾中：

步驟 3：連接並使用

運行 mcp.js 腳本（如上圖所示），並確保你的 MCP 服務器正在運行（Claude Desktop 或 Cursor 已加載並運行）。如果一切順利，你應該會看到以下界面： 點擊“連接”按鈕，你現在就可以和 Claude 交流你的下一個像素藝術大項目了！

🔧 技術細節

• 一次只能運行一個 MCP 服務器實例。
• 服務器需要端口 64823 處於空閒狀態。
• 服務器的實現比較粗糙且脆弱（詳見 架構文檔），並且沒有經過廣泛測試。
• MCP 資源的質量有點低，API 參考不清晰，示例有限，有時會讓大語言模型（LLM）感到困惑。如果您是 LibreSprite 專家，我們需要您的幫助。