Guitar Pro
Guitar Pro MCP Server ( for AI ) This project integrates PyGuitarPro with a Model Context Protocol (MCP) server, allowing you to manipulate Guitar Pro files programmatically.
What is Guitar Pro?
Guitar Pro is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to guitar pro mcp server ( for ai ) this project integrates pyguitarpro with a model context protocol (mcp) server, allowing you to manipulate guitar pro files programmatically.
Guitar Pro MCP Server ( for AI ) This project integrates PyGuitarPro with a Model Context Protocol (MCP) server, allowing you to manipulate Guitar Pro files programmatically.
This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Guitar Pro MCP Server ( for AI ) This project integrates PyG
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx guitar-proConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Guitar Pro
Guitar Pro MCP Server is a Python-based MCP server that integrates the PyGuitarPro library with the Model Context Protocol, allowing AI assistants to load, read, modify, and export Guitar Pro files programmatically. It exposes tools for managing tracks, measures, notes, time signatures, key signatures, and tempo, as well as exporting to MIDI and JSON formats and generating ASCII tab representations. Musicians, composers, and developers working with Guitar Pro 5 (.gp5) files can use it to automate music notation tasks through natural language.
Prerequisites
- Python 3.10 or higher installed
- uv package manager recommended (or pip as alternative)
- PyGuitarPro library and mido (MIDI library) — installed automatically via the package
- An MCP-compatible client such as Claude Desktop
- Guitar Pro 5 (.gp5) files to work with (other formats like .gp3 and .gp4 may have limited support)
Clone the repository
Clone the guitar-pro-mcp repository to your local machine.
git clone https://github.com/wegitor/guitar-pro-mcp.git
cd guitar-pro-mcpSet up a virtual environment with uv
Create and activate a Python virtual environment using uv, which is the recommended package manager for this project.
# Install uv if needed
pip install uv
# Create virtual environment
uv venv
# Activate (macOS/Linux)
source .venv/bin/activate
# Activate (Windows)
call .venv\Scripts\activate.batInstall the package
Install the guitar-pro-mcp package and all its dependencies including PyGuitarPro and mido.
uv pip install .Configure Claude Desktop
Add the Guitar Pro MCP server to claude_desktop_config.json. Use uv to run the server module with the project directory specified.
{
"mcpServers": {
"guitar-pro": {
"command": "uv",
"args": ["--directory", "/path/to/guitar-pro-mcp", "run", "-m", "src.run_mcp_server"]
}
}
}Restart Claude Desktop and load a Guitar Pro file
Restart Claude Desktop to activate the server. Ask Claude to load a .gp5 file by providing its full path, then explore or modify the song's tracks and notes.
Guitar Pro Examples
Client configuration
Claude Desktop configuration running the Guitar Pro MCP server using uv with the absolute path to the project directory.
{
"mcpServers": {
"guitar-pro": {
"command": "uv",
"args": ["--directory", "/Users/you/guitar-pro-mcp", "run", "-m", "src.run_mcp_server"]
}
}
}Prompts to try
Example prompts for loading, analyzing, and modifying Guitar Pro files through the AI assistant.
- "Load the file at /Users/me/songs/mysong.gp5 and show me the song info"
- "List all tracks in the currently loaded Guitar Pro file"
- "Get all notes from track 0 and show me the tab representation"
- "Set the tempo of measure 1 to 120 BPM"
- "Add a new track called 'Bass' and set it to instrument 33"
- "Export the current song to MIDI at /Users/me/songs/mysong.mid"
- "Export the current song structure to JSON for analysis"Troubleshooting Guitar Pro
PyGuitarPro fails to load a .gp4 or .gp3 file
The server has been primarily tested with Guitar Pro 5 (.gp5) format. Support for older formats is limited. Convert your files to .gp5 using Guitar Pro software before loading them through the MCP server.
uv command not found when starting the server
Install uv globally with 'pip install uv'. Alternatively, configure Claude Desktop to use the Python module directly: set 'command' to the full path of the venv Python binary and 'args' to ['-m', 'src.run_mcp_server'].
MIDI export fails with mido errors
Ensure mido is installed in your virtual environment ('uv pip show mido'). If the package install did not include it, run 'uv pip install mido' explicitly in the project virtual environment.
Frequently Asked Questions about Guitar Pro
What is Guitar Pro?
Guitar Pro is a Model Context Protocol (MCP) server that guitar pro mcp server ( for ai ) this project integrates pyguitarpro with a model context protocol (mcp) server, allowing you to manipulate guitar pro files programmatically. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Guitar Pro?
Follow the installation instructions on the Guitar Pro GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Guitar Pro?
Guitar Pro works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Guitar Pro free to use?
Yes, Guitar Pro is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Guitar Pro Alternatives — Similar File Systems Servers
Looking for alternatives to Guitar Pro? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.
Electerm
★ 14.1k📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)
Plik
★ 1.8kPlik is a temporary file upload system (Wetransfer like) in Go.
Kordoc
★ 957An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.
macOS Automator
★ 801A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.
PDF Reader
★ 723Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.
Filesystem MCP Server
★ 643Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.
Browse More File Systems MCP Servers
Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Guitar Pro in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Guitar Pro?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.