Pythonic MCP development, supercharged by AI intelligence and your will to build something new.
EvolveMCP gives Claude Desktop the ability to build, install, and use its own tools—expanding what it can actually do, not just talk about:
- Claude can write code for you that it can then use itself
- You can ask Claude to build specialized tools that solve your specific problems
- You can enhance Claude's capabilities beyond its default features
It turns Claude from a passive assistant into an active developer, capable of creating solutions as you need them.
Claude is the first client supported by the system, but EvolveMCP is built with a modular design. Support for other clients, tools and document collections is on the roadmap.
IMPORTANT: EvolveMCP allows Claude to create and execute Python code on your local machine. Before using this software, please understand the security implications by referring to the Security Implications section at the bottom.
Before starting, you'll need:
- Computer: Evolve is designed to work on Windows an 8000 d macOS
- Internet Connection: For downloading necessary files
- Claude Desktop: The desktop application for Claude
- Visit the official Anthropic website to download Claude Desktop
- Run the installer and follow the on-screen instructions
- Launch Claude Desktop at least once to create initial configuration files
- Go to github.com/kordless/EvolveMCP/releases/tag/newer
- Under "Assets", click on the zip file (something like
EvolveMCP-[version].zip) - Save the file to a location you can easily find (like your Downloads folder)
- Extract the archive:
- Windows: Right-click the downloaded zip file and select "Extract All..."
- macOS: Double-click the downloaded zip file to extract it
- Choose where to extract the files (like your Documents folder)
If you're familiar with Git:
- Install Git from git-scm.com if you don't have it
- Open Terminal (macOS) or PowerShell (Windows)
- Navigate to where you want to install Evolve
- Run these commands:
git clone https://github.com/kordless/EvolveMCP.git cd EvolveMCP
- Navigate to the folder where you extracted Evolve
- Hold Shift and right-click in an empty area of the folder
- Select "Open PowerShell window here" from the menu
- If you don't see this option, see our PowerShell Guide for alternatives
- Open Finder and navigate to the folder where you extracted Evolve
- Right-click (or Control-click) on the folder
- Select "New Terminal at Folder" or "Services" > "New Terminal at Folder"
- If you don't see this option, open Terminal (from Applications > Utilities) and use
cdto navigate to your folder
- If you don't see this option, open Terminal (from Applications > Utilities) and use
-
In the PowerShell window, type the following command and press Enter:
.\evolve.ps1 -Setup -
If you see an error message about execution policy, run this command and try again:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
-
In the Terminal window, make the script executable:
chmod +x ./evolve.sh
-
Run the setup command:
./evolve.sh --setup
-
If you need to install jq (required for JSON processing):
brew install jq
If you don't have Homebrew installed, visit brew.sh for installation instructions.
-
Follow any on-screen instructions to complete the setup
-
After setup completes, make sure you're still in PowerShell/Terminal in the Evolve folder
-
Start Claude with the Evolve tools available:
Windows:
.\evolve.ps1 -StartClaudemacOS:
./evolve.sh --restart
-
In Claude, ask it to create a calculator tool:
evolve_wizard("calc")You can also use conversational language like:
Could you please install the calculator tool for me? -
Claude will inform you that the calculator tool has been created and registered
-
Restart Claude to apply the changes:
Windows:
.\evolve.ps1 -RestartmacOS:
./evolve.sh --restart
-
After Claude restarts, you can test the calculator using either direct commands or natural language:
calculate("2 + 3 * 4")Or simply ask:
What's 2 plus 3 times 4?
One of the great features of Evolve is that you don't need to memorize exact command syntax. You can talk to Claude naturally, and it will understand what you're trying to do:
- Instead of
calculate("56 * 89"), you can ask "What's 56 multiplied by 89?" - Instead of
evolve_wizard("status"), you can ask "Can you show me the status of the Evolve system?" - Instead of formal parameter syntax, you can describe what you want in plain English
Claude will interpret your natural language requests and translate them into the appropriate tool calls as long as you provide enough information about what you want to accomplish.
The EvolveMCP utility provides several ways to view logs, which can be helpful for troubleshooting issues with Claude Desktop and MCP servers.
.\EvolveMCP.ps1 -ViewLogsTo filter logs by name:
.\EvolveMCP.ps1 -ViewLogs -LogName evolve./evolve.sh --view-logsTo filter logs by name:
./evolve.sh --view-logs --log-name evolveThis will show only log files that contain "evolve" in their filename.
If you prefer a menu-based approach:
.\EvolveMCP.ps1./evolve-mcp.shThen select option 1. View MCP Logs from the menu and choose a log file from the displayed list.
When viewing a log file, the tool will initially show the last 20 lines. You'll then be prompted if you want to monitor the log file in real-time. Selecting y will continuously display new log entries as they are written, which is particularly useful when debugging active issues.
To stop monitoring, press Ctrl+C.
Logs are stored in the following location:
Windows:
C:\Users\<username>\AppData\Roaming\Claude\logs
macOS:
~/Library/Application Support/Claude/logs
If this directory doesn't exist, the tool will offer to create it for you.
If Claude Desktop fails to start after configuring MCP servers:
-
Check the logs for any error messages:
Windows:
.\EvolveMCP.ps1 -ViewLogsmacOS:
./evolve-mcp.sh --view-logs
-
Verify that your configuration file is correct:
Windows:
C:\Users\<username>\AppData\Roaming\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json -
Ensure the paths to your MCP server scripts are valid and accessible
If you're experiencing issues with the Evolve server:
-
View the Evolve-specific logs:
Windows:
.\EvolveMCP.ps1 -ViewLogs -LogName evolve
macOS:
./evolve-mcp.sh --view-logs --log-name evolve
-
Verify that
evolve.pyexists in the location specified in your configuration -
Make sure Python is properly installed and accessible from the command line
If Claude Desktop becomes unresponsive or you need to apply configuration changes:
Windows:
.\EvolveMCP.ps1 -RestartmacOS:
./evolve-mcp.sh --restartThis will gracefully stop and restart Claude Desktop.
To verify which MCP tools are currently configured:
Windows:
.\EvolveMCP.ps1 -ListToolsmacOS:
./evolve.sh --list-toolsThis will display all configured MCP servers, including:
- Server name
- Command and arguments
- Whether the script exists
- For Evolve tools: version and creation date (if available)
-
Code Execution Risk: Any code that runs on your computer has access to your system at the same permission level as the user running it. This includes your files, network, and potentially sensitive information.
-
Review Generated Code: While Evolve (and Claude) aim to create safe and useful tools, you should review any code that it generates before allowing it to run, especially if you're using it in a professional or sensitive environment.
-
No Warranty: This software is provided "as is" without warranty of any kind. The creators are not responsible for any damages or security incidents resulting from its use.
-
Recommended Precautions:
- Run EvolveMCP in a dedicated user account with limited permissions
- Backup important data before using new tools
- Consider using a virtual machine or container for additional isolation (we'll be working on making this easier soon)
- Keep your operating system and security software up to date
-
For Developers: If you're extending EvolveMCP, follow secure coding practices and avoid giving tools unnecessary system access.
By installing and using EvolveMCP, you acknowledge these risks and take responsibility for the code executed on your system.
EvolveMCP is released under the Sovereign v1.1 license, which balances open use with specific restrictions:
We stand at a unique crossroads in the relationship between human and artificial intelligence. Traditional software licenses were never designed for a world where:
- AI can create, modify, and execute code based on natural language instructions
- The lines between user, creator, and tool become increasingly blurred
- The same software might be used by individuals, corporations, and potentially autonomous AI systems
- Digital and analog minds each bring distinct forms of intelligence and capabilities
The Sovereign license represents our attempt to navigate this unprecedented territory - acknowledging that just as AI must evolve, so too must our legal frameworks. Inspired by philosophical frameworks like those in the Gnosis AI-Sovereign License, this approach recognizes the need for graduated rights and responsibilities that differ based on the nature of the entity using the software.
- Individual Use: You can freely use this software as an individual, even for work-related tasks.
- Personal Projects: Use it in your personal projects without restriction.
- Small Business Use: Sole proprietors and small businesses can use it for internal purposes.
- Learning & Teaching: Use it in educational contexts without limitation.
- Modify & Extend: You can modify the code for your own use.
- Corporate Production: Corporations cannot deploy this software in production environments or integrate it into commercial products without a separate license.
- Resell the Software: You cannot sell EvolveMCP as a product or service.
- Remove Attribution: You must maintain all copyright and license notices.
This license allows you as an individual to use EvolveMCP freely, even if it helps with your job. However, your employer (if it's a corporation) cannot officially deploy it in production systems or incorporate it into their products without obtaining proper licensing.
This approach represents a fair attempt to balance open access with sustainable development in the rapidly evolving AI landscape. It envisions a future where human creativity, compassion, and embodied wisdom work in concert with the precision, scalability, and analytical power of artificial intelligence - a symbiotic relationship rather than an adversarial one.
For complete details, please refer to the full LICENSE.md file.