[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-ahujasid--ableton-mcp":3,"tool-ahujasid--ableton-mcp":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",144730,2,"2026-04-07T23:26:32",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107888,"2026-04-06T11:32:50",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":65,"owner_avatar_url":73,"owner_bio":65,"owner_company":65,"owner_location":65,"owner_email":65,"owner_twitter":74,"owner_website":65,"owner_url":75,"languages":76,"stars":85,"forks":86,"last_commit_at":87,"license":88,"difficulty_score":89,"env_os":90,"env_gpu":91,"env_ram":91,"env_deps":92,"category_tags":97,"github_topics":65,"view_count":32,"oss_zip_url":65,"oss_zip_packed_at":65,"status":17,"created_at":99,"updated_at":100,"faqs":101,"releases":131},5312,"ahujasid\u002Fableton-mcp","ableton-mcp",null,"ableton-mcp 是一款将 Ableton Live 音乐制作软件与 Claude AI 智能连接的创新工具。它基于模型上下文协议（MCP），让创作者可以直接通过自然语言对话来控制音乐工程，实现“用说话来作曲”的体验。\n\n传统音乐制作往往需要繁琐的手动操作和深厚的乐理知识，而 ableton-mcp 解决了这一痛点。用户只需向 AI 发出指令，即可自动完成创建音轨、加载乐器效果器、编写 MIDI 音符以及控制播放停止等复杂任务，极大地降低了创作门槛并提升了工作流效率。\n\n这款工具特别适合音乐制作人、声音设计师以及希望探索 AI 辅助创作的开发者使用。无论是想快速捕捉灵感的独立音乐人，还是试图构建自动化编曲流程的技术极客，都能从中受益。\n\n其核心技术亮点在于实现了双向实时通信：通过在 Ableton 内部部署专用的远程脚本服务器，并与外部的 MCP 服务端协同工作，确保了 AI 指令能精准、低延迟地转化为具体的软件操作。这种深度集成让 Claude 不仅能“理解”音乐结构，更能直接“动手”修改工程文件，为智能音乐生产开辟了新的可能性。","# AbletonMCP - Ableton Live Model Context Protocol Integration\n[![smithery badge](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fahujasid_ableton-mcp_readme_2ab22774b7ca.png)](https:\u002F\u002Fsmithery.ai\u002Fserver\u002F@ahujasid\u002Fableton-mcp)\n\nAbletonMCP connects Ableton Live to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Ableton Live. This integration enables prompt-assisted music production, track creation, and Live session manipulation.\n\n### Join the Community\n\nGive feedback, get inspired, and build on top of the MCP: [Discord](https:\u002F\u002Fdiscord.gg\u002F3ZrMyGKnaU). Made by [Siddharth](https:\u002F\u002Fx.com\u002Fsidahuj)\n\n## Features\n\n- **Two-way communication**: Connect Claude AI to Ableton Live through a socket-based server\n- **Track manipulation**: Create, modify, and manipulate MIDI and audio tracks\n- **Instrument and effect selection**: Claude can access and load the right instruments, effects and sounds from Ableton's library\n- **Clip creation**: Create and edit MIDI clips with notes\n- **Session control**: Start and stop playback, fire clips, and control transport\n\n## Components\n\nThe system consists of two main components:\n\n1. **Ableton Remote Script** (`Ableton_Remote_Script\u002F__init__.py`): A MIDI Remote Script for Ableton Live that creates a socket server to receive and execute commands\n2. **MCP Server** (`server.py`): A Python server that implements the Model Context Protocol and connects to the Ableton Remote Script\n\n## Installation\n\n### Installing via Smithery\n\nTo install Ableton Live Integration for Claude Desktop automatically via [Smithery](https:\u002F\u002Fsmithery.ai\u002Fserver\u002F@ahujasid\u002Fableton-mcp):\n\n```bash\nnpx -y @smithery\u002Fcli install @ahujasid\u002Fableton-mcp --client claude\n```\n\n### Prerequisites\n\n- Ableton Live 10 or newer\n- Python 3.8 or newer\n- [uv package manager](https:\u002F\u002Fastral.sh\u002Fuv)\n\nIf you're on Mac, please install uv as:\n```\nbrew install uv\n```\n\nOtherwise, install from [uv's official website][https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002Fgetting-started\u002Finstallation\u002F]\n\n⚠️ Do not proceed before installing UV\n\n### Claude for Desktop Integration\n\n[Follow along with the setup instructions video](https:\u002F\u002Fyoutu.be\u002FiJWJqyVuPS8)\n\n1. Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:\n\n```json\n{\n    \"mcpServers\": {\n        \"AbletonMCP\": {\n            \"command\": \"uvx\",\n            \"args\": [\n                \"ableton-mcp\"\n            ]\n        }\n    }\n}\n```\n\n### Cursor Integration\n\nRun ableton-mcp without installing it permanently through uvx. Go to Cursor Settings > MCP and paste this as a command:\n\n```\nuvx ableton-mcp\n```\n\n⚠️ Only run one instance of the MCP server (either on Cursor or Claude Desktop), not both\n\n### Installing the Ableton Remote Script\n\n[Follow along with the setup instructions video](https:\u002F\u002Fyoutu.be\u002FiJWJqyVuPS8)\n\n1. Download the `AbletonMCP_Remote_Script\u002F__init__.py` file from this repo\n\n2. Copy the folder to Ableton's MIDI Remote Scripts directory. Different OS and versions have different locations. **One of these should work, you might have to look**:\n\n   **For macOS:**\n   - Method 1: Go to Applications > Right-click on Ableton Live app → Show Package Contents → Navigate to:\n     `Contents\u002FApp-Resources\u002FMIDI Remote Scripts\u002F`\n   - Method 2: If it's not there in the first method, use the direct path (replace XX with your version number):\n     `\u002FUsers\u002F[Username]\u002FLibrary\u002FPreferences\u002FAbleton\u002FLive XX\u002FUser Remote Scripts`\n   \n   **For Windows:**\n   - Method 1:\n     C:\\Users\\[Username]\\AppData\\Roaming\\Ableton\\Live x.x.x\\Preferences\\User Remote Scripts \n   - Method 2:\n     `C:\\ProgramData\\Ableton\\Live XX\\Resources\\MIDI Remote Scripts\\`\n   - Method 3:\n     `C:\\Program Files\\Ableton\\Live XX\\Resources\\MIDI Remote Scripts\\`\n   *Note: Replace XX with your Ableton version number (e.g., 10, 11, 12)*\n\n4. Create a folder called 'AbletonMCP' in the Remote Scripts directory and paste the downloaded '\\_\\_init\\_\\_.py' file\n\n3. Launch Ableton Live\n\n4. Go to Settings\u002FPreferences → Link, Tempo & MIDI\n\n5. In the Control Surface dropdown, select \"AbletonMCP\"\n\n6. Set Input and Output to \"None\"\n\n## Usage\n\n### Starting the Connection\n\n1. Ensure the Ableton Remote Script is loaded in Ableton Live\n2. Make sure the MCP server is configured in Claude Desktop or Cursor\n3. The connection should be established automatically when you interact with Claude\n\n### Using with Claude\n\nOnce the config file has been set on Claude, and the remote script is running in Ableton, you will see a hammer icon with tools for the Ableton MCP.\n\n## Capabilities\n\n- Get session and track information\n- Create and modify MIDI and audio tracks\n- Create, edit, and trigger clips\n- Control playback\n- Load instruments and effects from Ableton's browser\n- Add notes to MIDI clips\n- Change tempo and other session parameters\n\n## Example Commands\n\nHere are some examples of what you can ask Claude to do:\n\n- \"Create an 80s synthwave track\" [Demo](https:\u002F\u002Fyoutu.be\u002FVH9g66e42XA)\n- \"Create a Metro Boomin style hip-hop beat\"\n- \"Create a new MIDI track with a synth bass instrument\"\n- \"Add reverb to my drums\"\n- \"Create a 4-bar MIDI clip with a simple melody\"\n- \"Get information about the current Ableton session\"\n- \"Load a 808 drum rack into the selected track\"\n- \"Add a jazz chord progression to the clip in track 1\"\n- \"Set the tempo to 120 BPM\"\n- \"Play the clip in track 2\"\n\n\n## Troubleshooting\n\n- **Connection issues**: Make sure the Ableton Remote Script is loaded, and the MCP server is configured on Claude\n- **Timeout errors**: Try simplifying your requests or breaking them into smaller steps\n- **Have you tried turning it off and on again?**: If you're still having connection errors, try restarting both Claude and Ableton Live\n\n## Technical Details\n\n### Communication Protocol\n\nThe system uses a simple JSON-based protocol over TCP sockets:\n\n- Commands are sent as JSON objects with a `type` and optional `params`\n- Responses are JSON objects with a `status` and `result` or `message`\n\n### Limitations & Security Considerations\n\n- Creating complex musical arrangements might need to be broken down into smaller steps\n- The tool is designed to work with Ableton's default devices and browser items\n- Always save your work before extensive experimentation\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## Disclaimer\n\nThis is a third-party integration and not made by Ableton.\n","# AbletonMCP - Ableton Live 模型上下文协议集成\n[![smithery 徽章](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fahujasid_ableton-mcp_readme_2ab22774b7ca.png)](https:\u002F\u002Fsmithery.ai\u002Fserver\u002F@ahujasid\u002Fableton-mcp)\n\nAbletonMCP 通过模型上下文协议 (MCP) 将 Ableton Live 连接到 Claude AI，使 Claude 能够直接与 Ableton Live 交互并进行控制。这种集成实现了基于提示的音乐制作、音轨创建以及 Live 会话操作。\n\n### 加入社区\n\n提供反馈、获取灵感，并在 MCP 的基础上进行开发：[Discord](https:\u002F\u002Fdiscord.gg\u002F3ZrMyGKnaU)。由 [Siddharth](https:\u002F\u002Fx.com\u002Fsidahuj) 制作。\n\n## 功能\n\n- **双向通信**：通过基于套接字的服务器将 Claude AI 连接到 Ableton Live\n- **音轨操作**：创建、修改和操作 MIDI 及音频音轨\n- **乐器与效果选择**：Claude 可以访问并加载 Ableton 库中的合适乐器、效果和音色\n- **片段创建**：创建和编辑包含音符的 MIDI 片段\n- **会话控制**：开始和停止播放、触发片段以及控制走带功能\n\n## 组件\n\n该系统由两个主要组件组成：\n\n1. **Ableton 遥控脚本**（`Ableton_Remote_Script\u002F__init__.py`）：一个用于 Ableton Live 的 MIDI 遥控脚本，用于创建套接字服务器以接收和执行命令。\n2. **MCP 服务器**（`server.py`）：一个实现模型上下文协议并与 Ableton 遥控脚本连接的 Python 服务器。\n\n## 安装\n\n### 通过 Smithery 安装\n\n要通过 [Smithery](https:\u002F\u002Fsmithery.ai\u002Fserver\u002F@ahujasid\u002Fableton-mcp) 自动安装 Claude Desktop 的 Ableton Live 集成：\n\n```bash\nnpx -y @smithery\u002Fcli install @ahujasid\u002Fableton-mcp --client claude\n```\n\n### 先决条件\n\n- Ableton Live 10 或更高版本\n- Python 3.8 或更高版本\n- [uv 包管理器](https:\u002F\u002Fastral.sh\u002Fuv)\n\n如果您使用的是 Mac，请按以下方式安装 uv：\n```\nbrew install uv\n```\n\n否则，请从 [uv 官方网站](https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002Fgetting-started\u002Finstallation\u002F) 安装。\n\n⚠️ 请务必先安装 UV 再继续。\n\n### Claude for Desktop 集成\n\n[按照设置说明视频操作](https:\u002F\u002Fyoutu.be\u002FiJWJqyVuPS8)\n\n1. 前往 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json，添加以下内容：\n\n```json\n{\n    \"mcpServers\": {\n        \"AbletonMCP\": {\n            \"command\": \"uvx\",\n            \"args\": [\n                \"ableton-mcp\"\n            ]\n        }\n    }\n}\n```\n\n### Cursor 集成\n\n通过 uvx 运行 ableton-mcp，而无需永久安装。前往 Cursor 设置 > MCP，并将以下命令粘贴进去：\n\n```\nuvx ableton-mcp\n```\n\n⚠️ 请仅运行 MCP 服务器的一个实例（无论是 Cursor 还是 Claude Desktop），不要同时运行两者。\n\n### 安装 Ableton 遥控脚本\n\n[按照设置说明视频操作](https:\u002F\u002Fyoutu.be\u002FiJWJqyVuPS8)\n\n1. 从本仓库下载 `AbletonMCP_Remote_Script\u002F__init__.py` 文件。\n\n2. 将该文件夹复制到 Ableton 的 MIDI 遥控脚本目录中。不同操作系统和版本的路径可能有所不同。**以下路径中应该有一个有效，您可能需要查找一下**：\n\n   **对于 macOS：**\n   - 方法 1：前往“应用程序”→右键点击 Ableton Live 应用程序 → 显示包内容 → 导航至：\n     `Contents\u002FApp-Resources\u002FMIDI Remote Scripts\u002F`\n   - 方法 2：如果第一种方法找不到，可以使用直接路径（将 XX 替换为您的版本号）：\n     `\u002FUsers\u002F[用户名]\u002FLibrary\u002FPreferences\u002FAbleton\u002FLive XX\u002FUser Remote Scripts`\n\n   **对于 Windows：**\n   - 方法 1：\n     C:\\Users\\[用户名]\\AppData\\Roaming\\Ableton\\Live x.x.x\\Preferences\\User Remote Scripts \n   - 方法 2：\n     `C:\\ProgramData\\Ableton\\Live XX\\Resources\\MIDI Remote Scripts\\`\n   - 方法 3：\n     `C:\\Program Files\\Ableton\\Live XX\\Resources\\MIDI Remote Scripts\\`\n   *注：将 XX 替换为您的 Ableton 版本号（例如 10、11、12）*\n\n4. 在遥控脚本目录中创建一个名为“AbletonMCP”的文件夹，并将下载的 `__init__.py` 文件粘贴进去。\n\n3. 启动 Ableton Live。\n\n4. 前往设置\u002F偏好设置 → 链接、速度与 MIDI。\n\n5. 在“控制表面”下拉菜单中选择“AbletonMCP”。\n\n6. 将输入和输出设置为“无”。\n\n## 使用\n\n### 启动连接\n\n1. 确保 Ableton Live 中已加载 Ableton 遥控脚本。\n2. 确保 MCP 服务器已在 Claude Desktop 或 Cursor 中配置好。\n3. 当您与 Claude 交互时，连接应自动建立。\n\n### 与 Claude 配合使用\n\n一旦在 Claude 上设置了配置文件，并且遥控脚本在 Ableton 中运行，您将看到一个带有 Ableton MCP 工具的锤子图标。\n\n## 功能\n\n- 获取会话和音轨信息\n- 创建和修改 MIDI 和音频音轨\n- 创建、编辑和触发片段\n- 控制播放\n- 从 Ableton 浏览器加载乐器和效果\n- 向 MIDI 片段添加音符\n- 更改速度和其他会话参数\n\n## 示例命令\n\n以下是一些您可以要求 Claude 执行的例子：\n\n- “创建一首 80 年代合成器浪潮风格的曲目” [演示](https:\u002F\u002Fyoutu.be\u002FVH9g66e42XA)\n- “创建一段 Metro Boomin 风格的嘻哈节拍”\n- “创建一条带有合成贝斯乐器的新 MIDI 音轨”\n- “为我的鼓声添加混响”\n- “创建一个包含简单旋律的 4 小节 MIDI 片段”\n- “获取当前 Ableton 会话的信息”\n- “将 808 鼓架加载到选定的音轨中”\n- “在第 1 音轨的片段中加入爵士和弦进行”\n- “将速度设置为 120 BPM”\n- “播放第 2 音轨中的片段”\n\n## 故障排除\n\n- **连接问题**：确保 Ableton 遥控脚本已加载，并且 MCP 服务器已在 Claude 中正确配置。\n- **超时错误**：尝试简化您的请求或将它们分解为更小的步骤。\n- **重启过吗？**：如果仍然存在连接问题，请尝试重新启动 Claude 和 Ableton Live。\n\n## 技术细节\n\n### 通信协议\n\n系统使用基于 JSON 的简单协议，通过 TCP 套接字进行通信：\n\n- 命令以 JSON 对象的形式发送，包含 `type` 和可选的 `params`。\n- 响应也是 JSON 对象，包含 `status` 以及 `result` 或 `message`。\n\n### 限制与安全考虑\n\n- 创建复杂的音乐编排可能需要分解为更小的步骤。\n- 该工具设计用于与 Ableton 的默认设备和浏览器项目配合使用。\n- 在进行大量实验之前，请务必保存您的工作。\n\n## 贡献\n\n欢迎贡献！请随时提交 Pull Request。\n\n## 免责声明\n\n这是一个第三方集成，并非由 Ableton 开发。","# AbletonMCP 快速上手指南\n\nAbletonMCP 通过模型上下文协议（MCP）将 Ableton Live 与 Claude AI 连接，使 AI 能够直接控制音乐制作软件，实现提示词辅助创作、轨道管理及会话控制。\n\n## 环境准备\n\n在开始之前，请确保满足以下系统要求和依赖：\n\n*   **操作系统**：macOS 或 Windows\n*   **软件版本**：Ableton Live 10 或更高版本\n*   **运行环境**：Python 3.8 或更高版本\n*   **包管理器**：[uv](https:\u002F\u002Fastral.sh\u002Fuv) (必须安装)\n\n**安装 uv：**\n\n*   **macOS 用户**：\n    ```bash\n    brew install uv\n    ```\n*   **Windows\u002FLinux 用户**：\n    请访问 [uv 官方安装文档](https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002Fgetting-started\u002Finstallation\u002F) 进行安装。\n\n> ⚠️ **注意**：在未安装 `uv` 之前请勿继续后续步骤。\n\n## 安装步骤\n\n本工具由两部分组成：**Ableton 远程脚本**（运行在 Ableton 内）和 **MCP 服务器**（运行在 Claude\u002FCursor 中）。\n\n### 第一步：配置 Ableton 远程脚本\n\n1.  从项目仓库下载 `Ableton_Remote_Script\u002F__init__.py` 文件。\n2.  将该文件放入 Ableton Live 的 MIDI Remote Scripts 目录中。根据系统和版本不同，路径可能如下（请将 `XX` 替换为你的版本号，如 11, 12）：\n\n    *   **macOS**:\n        *   方法 A：右键点击 Ableton Live 应用 → 显示包内容 → `Contents\u002FApp-Resources\u002FMIDI Remote Scripts\u002F`\n        *   方法 B：`\u002FUsers\u002F[用户名]\u002FLibrary\u002FPreferences\u002FAbleton\u002FLive XX\u002FUser Remote Scripts`\n    *   **Windows**:\n        *   `C:\\Users\\[用户名]\\AppData\\Roaming\\Ableton\\Live x.x.x\\Preferences\\User Remote Scripts`\n        *   或 `C:\\Program Files\\Ableton\\Live XX\\Resources\\MIDI Remote Scripts\\`\n\n3.  在上述目录中新建文件夹 `AbletonMCP`，并将 `__init__.py` 文件粘贴进去。\n4.  启动 Ableton Live。\n5.  进入 **Settings\u002FPreferences** → **Link, Tempo & MIDI**。\n6.  在 **Control Surface** 下拉菜单中选择 `AbletonMCP`。\n7.  将对应的 **Input** 和 **Output** 均设置为 `None`。\n\n### 第二步：配置 MCP 服务器\n\n根据你的使用场景，选择 **Claude Desktop** 或 **Cursor** 其中一种方式进行配置（⚠️ 请勿同时运行两个实例）。\n\n#### 选项 A：Claude Desktop 集成\n\n1.  打开配置文件：`claude_desktop_config.json`\n    *   路径通常在：Claude 应用菜单 > Settings > Developer > Edit Config\n2.  在 `mcpServers` 字段中添加以下配置：\n\n    ```json\n    {\n        \"mcpServers\": {\n            \"AbletonMCP\": {\n                \"command\": \"uvx\",\n                \"args\": [\n                    \"ableton-mcp\"\n                ]\n            }\n        }\n    }\n    ```\n\n#### 选项 B：Cursor 集成\n\n1.  打开 Cursor 设置，找到 **MCP** 部分。\n2.  添加新的 MCP 服务器，命令填写：\n    ```bash\n    uvx ableton-mcp\n    ```\n\n## 基本使用\n\n完成上述配置后，即可开始使用 AI 控制 Ableton Live。\n\n1.  **启动服务**：确保 Ableton Live 已加载 `AbletonMCP` 控制表面，且 Claude Desktop 或 Cursor 已重启以加载配置。\n2.  **建立连接**：在聊天窗口中与 Claude 对话，连接会自动建立。成功连接后，输入框附近会出现一个锤子图标（工具标识）。\n3.  **发送指令**：直接使用自然语言下达音乐制作指令。\n\n**使用示例：**\n\n*   创建特定风格的曲目：\n    > \"Create an 80s synthwave track\"\n    > （创建一个 80 年代合成器浪潮风格的曲目）\n\n*   添加乐器与效果：\n    > \"Create a new MIDI track with a synth bass instrument\"\n    > （创建一个带有合成贝斯乐器的新 MIDI 轨道）\n    > \"Add reverb to my drums\"\n    > （给我的鼓组添加混响效果）\n\n*   编辑片段与控制播放：\n    > \"Create a 4-bar MIDI clip with a simple melody\"\n    > （创建一个包含简单旋律的 4 小节 MIDI 片段）\n    > \"Set the tempo to 120 BPM\"\n    > （将速度设置为 120 BPM）\n    > \"Play the clip in track 2\"\n    > （播放第 2 轨的片段）\n\n> 💡 **提示**：对于复杂的编曲任务，建议将需求拆分为多个小步骤依次发送给 AI，以获得更稳定的执行结果。操作前请记得保存你的工程文件。","独立音乐制作人阿明正在为一款独立游戏创作动态背景音乐，他需要根据剧情节奏快速生成并调整多个变奏段落。\n\n### 没有 ableton-mcp 时\n- **操作打断心流**：每次想尝试新乐器或效果器，都必须停下构思，手动在 Ableton Live 庞大的浏览器中层层查找并拖拽加载。\n- **重复劳动繁琐**：修改 MIDI 音符、调整剪辑长度或复制轨道结构时，需频繁使用鼠标点击和键盘快捷键，机械性操作耗时极长。\n- **创意验证缓慢**：想要测试“把这段旋律改成小调并加上混响”的想法，需要分步执行多个操作，导致灵感在等待中流失。\n- **多任务切换困难**：一边查阅资料或写提示词，一边操作 DAW（数字音频工作站），注意力在不同窗口间不断跳跃，效率低下。\n\n### 使用 ableton-mcp 后\n- **语音即指令**：阿明只需对 Claude 说“加载一个复古合成器音色到第二轨”，ableton-mcp 立刻自动完成搜索与加载，让创作思路不间断。\n- **自然语言编曲**：直接描述“将第 5 小节的音符全部降低半音并延长时值”，ableton-mcp 即刻精准修改 MIDI 剪辑，省去手动逐个编辑的麻烦。\n- **即时创意迭代**：发出“给主歌部分添加侧链压缩并循环播放”的指令，ableton-mcp 瞬间配置好效果器并控制播放状态，秒级验证听觉效果。\n- **沉浸式工作流**：全程在对话窗口中通过自然语言指挥 Ableton Live，无需切换界面，实现了从“想法”到“声音”的零延迟转化。\n\nableton-mcp 将繁琐的软件操作转化为自然的语言交互，让音乐人从技术执行者回归纯粹的创意主导者。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fahujasid_ableton-mcp_0ae699f5.png","ahujasid","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fahujasid_d090b6f8.png","sidahuj","https:\u002F\u002Fgithub.com\u002Fahujasid",[77,81],{"name":78,"color":79,"percentage":80},"Python","#3572A5",99.4,{"name":82,"color":83,"percentage":84},"Dockerfile","#384d54",0.6,2379,299,"2026-04-07T10:37:07","MIT",4,"macOS, Windows","未说明",{"notes":93,"python":94,"dependencies":95},"必须安装 Ableton Live 10 或更高版本；需使用 uv 包管理器；需要在 Ableton Live 中手动安装特定的 MIDI Remote Script（__init__.py）并配置控制表面；MCP 服务器实例（如在 Claude Desktop 或 Cursor 中）同一时间只能运行一个。","3.8+",[96,64],"uv",[98,13,52],"音频","2026-03-27T02:49:30.150509","2026-04-08T10:16:07.997612",[102,107,112,117,122,127],{"id":103,"question_zh":104,"answer_zh":105,"source_url":106},24089,"macOS 上出现 RemoteScriptError 语法错误（SyntaxError: invalid syntax）如何解决？","此问题通常由以下两个原因导致：\n1. 文件夹命名错误：检查 MIDI Remote Scripts 文件夹下的安装目录，确保文件夹名为 \"AbletonMCP\"，中间不能有空格（即不能是 \"Ableton MCP\"）。\n2. 代码导入错误：不要使用 `import Ableton MCP`，正确的导入语句应为 `from _Framework.ControlSurface import ControlSurface`。\n此外，建议删除 MCP JSON 配置中的重复项，并严格按照 README 复制配置文件。","https:\u002F\u002Fgithub.com\u002Fahujasid\u002Fableton-mcp\u002Fissues\u002F24",{"id":108,"question_zh":109,"answer_zh":110,"source_url":111},24090,"工具提示“无法记录工具结果”或生成轨道但没有 MIDI 片段是怎么回事？","这通常是因为 Claude 服务暂时不可用或正在进行维护更新，而非本地配置错误。当看到此类错误或发现能创建轨道和 BPM 但无法生成 MIDI 片段时，请稍后重试。可以关注官方状态页面确认服务是否恢复。","https:\u002F\u002Fgithub.com\u002Fahujasid\u002Fableton-mcp\u002Fissues\u002F10",{"id":113,"question_zh":114,"answer_zh":115,"source_url":116},24091,"这个项目支持除 Ableton Live 以外的其他 DAW（如 Reaper, LMMS, Bitwig）吗？","目前主要支持 Ableton Live，但架构上可以扩展到其他 DAW。原理分为两部分：\n1. DAW 端的远程脚本（Ableton 使用 Python，Bitwig 使用 Java Controller Extensions）：负责建立 socket 服务器并调用 DAW API。\n2. MCP 服务器：作为桥接层，将 AI 指令转换为发送给远程脚本的命令。\n若要支持其他 DAW，需要编写该 DAW 专用的远程脚本来接收命令，并复用或适配现有的 MCP 服务器通过 OSC、HTTP 或 Sockets 进行通信。","https:\u002F\u002Fgithub.com\u002Fahujasid\u002Fableton-mcp\u002Fissues\u002F2",{"id":118,"question_zh":119,"answer_zh":120,"source_url":121},24088,"遇到“无法连接到 Ableton，请确保远程脚本正在运行”的错误怎么办？","尝试更新 claude_desktop_config.json 配置文件。将命令改为使用 uvx 运行 ableton-mcp，配置示例如下：\n{\n  \"mcpServers\": {\n      \"AbletonMCP\": {\n          \"command\": \"uvx\",\n          \"args\": [\n              \"ableton-mcp\"\n          ]\n      }\n  }\n}\n确保配置中的服务器名称与远程脚本文件夹名称一致。","https:\u002F\u002Fgithub.com\u002Fahujasid\u002Fableton-mcp\u002Fissues\u002F48",{"id":123,"question_zh":124,"answer_zh":125,"source_url":126},24092,"在 Windows 上安装了 init.py 文件，但在设置菜单中找不到 AbletonMCP 选项怎么办？","如果在 Windows 11 和 Ableton Live Lite 12 环境下，复制了 init.py 文件后仍无法在控制表面（Control Surface）设置中看到 AbletonMCP 选项，请检查以下几点：\n1. 确认文件路径是否正确：通常位于 `C:\\ProgramData\\Ableton\\Live 12 Suite\\Resources\\MIDI Remote Scripts\\` 或用户库目录下。\n2. 确保文件夹名称严格为 \"AbletonMCP\"，无多余空格或字符。\n3. 检查 __init__.py 文件内是否正确定义了 AbletonMCP 类。\n4. 尝试重启 Ableton Live。如果使用的是 Lite 版本，请确认该版本是否支持加载自定义远程脚本。","https:\u002F\u002Fgithub.com\u002Fahujasid\u002Fableton-mcp\u002Fissues\u002F30",{"id":128,"question_zh":129,"answer_zh":130,"source_url":121},24093,"如何正确配置 macOS 上的 IAC Driver 和 MIDI 端口？","在 macOS 上连接 Ableton-MCP 需要正确配置虚拟 MIDI 端口：\n1. 打开“音频 MIDI 设置”（Audio MIDI Setup），确保 IAC Driver 已开启且 Bus 1 可用。\n2. 在 Ableton Live 的偏好设置 -> Link\u002FMIDI 中，将 Control Surface 设置为 AbletonMCP。\n3. Input（输入）和 Output（输出）均选择 \"IAC Driver (Bus 1)\"。\n4. 确保没有其他控制表面槽位重复使用了 AbletonMCP 实例。\n5. 验证远程脚本安装的端口配置是否为 localhost:9877。",[]]