EvolveMCP: Build. Extend. Evolve.
<strong>Pythonic MCP development, supercharged by AI intelligence and your will to build something new.</strong>
Beginner s Guide to Installing EvolveMCP
Demo Video
Watch a demonstration of the Bitcoin price tracking app created with EvolveMCP, showing how Claude can build and use its own tools to fetch and visualize real-time cryptocurrency data.
What is EvolveMCP?
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.
Security Warning
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.
Prerequisites
Before starting, you'll need:
- Computer: Evolve is designed to work on Windows and macOS
- Internet Connection: For downloading necessary files
- Claude Desktop: The desktop application for Claude
Step 1: Install Claude Desktop
- 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
Step 2: Download Evolve
Option A: Download the Release Package (Easiest)
- 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:
- Choose where to extract the files (like your Documents folder)
Option B: Using Git (For Advanced Users)
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:
Step 3: Open Terminal/PowerShell
Windows
- 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
macOS
- 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"
Step 4: Run the Setup Script
Windows
- In the PowerShell window, type the following command and press Enter:
- If you see an error message about execution policy, run this command and try again:
macOS
- In the Terminal window, make the script executable:
- Run the setup command:
- If you need to install jq (required for JSON processing):If you don't have Homebrew installed, visit brew.sh for installation instructions.
- Follow any on-screen instructions to complete the setup
Step 5: Create Your First Tool
- After setup completes, make sure you're still in PowerShell/Terminal in the Evolve folder
- Start Claude with the Evolve tools available:Windows:macOS:
- In Claude, ask it to create a calculator tool:You can also use conversational language like:
- Claude will inform you that the calculator tool has been created and registered
- Restart Claude to apply the changes:Windows:macOS:
- After Claude restarts, you can test the calculator using either direct commands or natural language:Or simply ask:
Using Conversational Language with Evolve
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.
Troubleshooting
Viewing Logs
The EvolveMCP utility provides several ways to view logs, which can be helpful for troubleshooting issues with Claude Desktop and MCP servers.
Using the Command Line
Windows
To filter logs by name:
macOS
To filter logs by name:
This will show only log files that contain "evolve" in their filename.
Using the Menu Interface
If you prefer a menu-based approach:
Windows
macOS
Then select option
1. View MCP Logs from the menu and choose a log file from the displayed list.Log Monitoring
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.Log Location
Logs are stored in the following location:
Windows:
macOS:
If this directory doesn't exist, the tool will offer to create it for you.
Common Issues
Claude Desktop Not Starting
If Claude Desktop fails to start after configuring MCP servers:
- Check the logs for any error messages:Windows:macOS:
- Verify that your configuration file is correct:Windows:macOS:
- Ensure the paths to your MCP server scripts are valid and accessible
Evolve Server Issues
If you're experiencing issues with the Evolve server:
- View the Evolve-specific logs:Windows:macOS:
- Verify that
evolve.pyexists in the location specified in your configuration
- Make sure Python is properly installed and accessible from the command line
Restarting Claude Desktop
If Claude Desktop becomes unresponsive or you need to apply configuration changes:
Windows:
macOS:
This will gracefully stop and restart Claude Desktop.
Checking Tool Configuration
To verify which MCP tools are currently configured:
Windows:
macOS:
This 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)
Security Implications
- 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:
- 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.
License Explanation: Sovereign v1.1
EvolveMCP is released under the Sovereign v1.1 license, which balances open use with specific restrictions:
AI and the Evolution of Licensing
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.
What You CAN Do:
- 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.
What You CANNOT Do:
- 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.
In Simple Terms:
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.
EvolveMCP: Build. Extend. Evolve.
<strong>Pythonic MCP development, supercharged by AI intelligence and your will to build something new.</strong>
Beginner s Guide to Installing EvolveMCP
Demo Video
Watch a demonstration of the Bitcoin price tracking app created with EvolveMCP, showing how Claude can build and use its own tools to fetch and visualize real-time cryptocurrency data.
What is EvolveMCP?
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.
Security Warning
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.
Prerequisites
Before starting, you'll need:
- Computer: Evolve is designed to work on Windows and macOS
- Internet Connection: For downloading necessary files
- Claude Desktop: The desktop application for Claude
Step 1: Install Claude Desktop
- 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
Step 2: Download Evolve
Option A: Download the Release Package (Easiest)
- 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:
- Choose where to extract the files (like your Documents folder)
Option B: Using Git (For Advanced Users)
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:
Step 3: Open Terminal/PowerShell
Windows
- 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
macOS
- 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"
Step 4: Run the Setup Script
Windows
- In the PowerShell window, type the following command and press Enter:
- If you see an error message about execution policy, run this command and try again:
macOS
- In the Terminal window, make the script executable:
- Run the setup command:
- If you need to install jq (required for JSON processing):If you don't have Homebrew installed, visit brew.sh for installation instructions.
- Follow any on-screen instructions to complete the setup
Step 5: Create Your First Tool
- After setup completes, make sure you're still in PowerShell/Terminal in the Evolve folder
- Start Claude with the Evolve tools available:Windows:macOS:
- In Claude, ask it to create a calculator tool:You can also use conversational language like:
- Claude will inform you that the calculator tool has been created and registered
- Restart Claude to apply the changes:Windows:macOS:
- After Claude restarts, you can test the calculator using either direct commands or natural language:Or simply ask:
Using Conversational Language with Evolve
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.
Troubleshooting
Viewing Logs
The EvolveMCP utility provides several ways to view logs, which can be helpful for troubleshooting issues with Claude Desktop and MCP servers.
Using the Command Line
Windows
To filter logs by name:
macOS
To filter logs by name:
This will show only log files that contain "evolve" in their filename.
Using the Menu Interface
If you prefer a menu-based approach:
Windows
macOS
Then select option
1. View MCP Logs from the menu and choose a log file from the displayed list.Log Monitoring
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.Log Location
Logs are stored in the following location:
Windows:
macOS:
If this directory doesn't exist, the tool will offer to create it for you.
Common Issues
Claude Desktop Not Starting
If Claude Desktop fails to start after configuring MCP servers:
- Check the logs for any error messages:Windows:macOS:
- Verify that your configuration file is correct:Windows:macOS:
- Ensure the paths to your MCP server scripts are valid and accessible
Evolve Server Issues
If you're experiencing issues with the Evolve server:
- View the Evolve-specific logs:Windows:macOS:
- Verify that
evolve.pyexists in the location specified in your configuration
- Make sure Python is properly installed and accessible from the command line
Restarting Claude Desktop
If Claude Desktop becomes unresponsive or you need to apply configuration changes:
Windows:
macOS:
This will gracefully stop and restart Claude Desktop.
Checking Tool Configuration
To verify which MCP tools are currently configured:
Windows:
macOS:
This 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)
Security Implications
- 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:
- 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.
License Explanation: Sovereign v1.1
EvolveMCP is released under the Sovereign v1.1 license, which balances open use with specific restrictions:
AI and the Evolution of Licensing
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.
What You CAN Do:
- 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.
What You CANNOT Do:
- 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.
In Simple Terms:
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.