ICPilot is an MCP (Model Context Protocol) server that integrates the Internet Computer Protocol (ICP) ecosystem with AI assistants. It enables natural language interaction with ICP development tools through MCP-compatible platforms like Claude, Cursor, and other AI coding assistants.

Think of ICPilot as your AI-powered assistant for Internet Computer development. Instead of memorizing complex commands and workflows, you can simply tell your AI assistant what you want to achieve in plain English. Whether you're creating canisters, managing identities, or deploying smart contracts, ICPilot translates your natural language into the appropriate ICP ecosystem commands.

1. Node.js (version 16 or higher)

   • Check if you have it: Open Terminal and type node --version
   • If not installed: Download from nodejs.org

2. dfx CLI (Internet Computer SDK)

   • Check if you have it: Open Terminal and type dfx --version
   • If not installed: Run this command:

   sh -ci "$(curl -fsSL https://internetcomputer.org/install.sh)"

3. MCP-Compatible AI Assistant

   • Claude Desktop: claude.ai/download
   • Cursor: cursor.sh
   • Or any other MCP-compatible platform

1. Open Terminal (on Mac: press Cmd+Space, type "Terminal", press Enter)
2. Navigate to this folder:

   cd /Users/tolga/Desktop/icpilot

3. Install dependencies:

   npm install

4. Build the server:

   npm run build

1. Find your MCP configuration file:

   • Claude Desktop:
     • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
     • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Cursor: Check Cursor's MCP documentation for config location
   • Other platforms: Refer to your platform's MCP setup guide

2. Open the file in a text editor and add this configuration:

   {
     "mcpServers": {
       "icpilot": {
         "command": "node",
         "args": ["/Users/tolga/Desktop/icpilot/build/index.js"],
         "env": {}
       }
     }
   }

3. Save the file and restart your MCP client

Once everything is set up, you can ask your AI assistant to do things like:

You say: "Create a new dfx project called hello_world"

What happens: Your AI assistant will create a new Internet Computer project with all the necessary files.

You say: "Start the dfx local environment in the background"

What happens: The local blockchain environment will start where you can test your apps.

You say: "Create a new identity called alice"

What happens: A new user identity will be created for testing different user roles.

You say: "Show me all my identities"

What happens: You'll see all available identities and which one is currently active.

## How It Works (Simple Explanation)

1. You describe what you want to do in the ICP ecosystem
2. Your AI assistant understands your intent
3. ICPilot translates this to the appropriate ICP commands
4. The commands execute on your local machine
5. You see the results and next steps

It's like having an experienced ICP developer sitting next to you, handling all the technical commands while you focus on building!