netixc/aida-mcp

AIDA Code MCP Server

An MCP (Model Context Protocol) server that allows running AIDA in one-shot mode with permissions bypassed automatically.

AIDA

Overview

This MCP server provides one tool that can be used by LLMs to interact with AIDA, it allows LLMs to:

• Run AIDA with all permissions bypassed (using --dangerously-skip-permissions)
• Execute AIDA with any prompt without permission interruptions
• Access file editing capabilities directly
• Enable specific tools by default

Prerequisites

• Node.js v20 or later (Use fnm or nvm to install)
• AIDA CLI installed locally and available in PATH

  # Install AIDA globally
  npm install -g @netixc/aida
  
  # Or use it from source
  cd /path/to/aida
  npm install
  npm run build
  npm link
  

• Run AIDA once with --dangerously-skip-permissions to accept terms:

  aida --dangerously-skip-permissions
  

Configuration

Environment Variables

• AIDA_CLI_NAME: Override the AIDA CLI binary name or provide an absolute path (default: aida).

  • Simple name: AIDA_CLI_NAME=aida-custom
  • Absolute path: AIDA_CLI_NAME=/path/to/custom/aida
  • Relative paths are not allowed and will throw an error

• MCP_CLAUDE_DEBUG: Enable debug logging (set to true for verbose output)

Installation & Usage

Build from Source

cd aida-mcp
npm install
npm run build

Configure Your MCP Client

MCP-CLIENT

{
  "mcpServers": {
    "aida-code-mcp": {
      "command": "node",
      "args": ["/path/to/claude-code-mcp/dist/server.js"]
    }
  }
}

Using Custom AIDA Path

If your AIDA installation is in a non-standard location:

{
  "mcpServers": {
    "aida-code-mcp": {
      "command": "node",
      "args": ["/path/to/claude-code-mcp/dist/server.js"],
      "env": {
        "AIDA_CLI_NAME": "/path/to/your/aida"
      }
    }
  }
}

Tools Provided

aida_code

Executes a prompt directly using the AIDA CLI with --dangerously-skip-permissions and --print flags.

Arguments:

• prompt (string, required): The prompt to send to AIDA.
• workFolder (string, optional): The working directory for AIDA execution. Must be an absolute path.

Example MCP Request:

{
  "toolName": "aida_code",
  "arguments": {
    "prompt": "Refactor the function foo in main.py to be async.",
    "workFolder": "/Users/username/my-project"
  }
}

Key Use Cases

1. Code Generation, Analysis & Refactoring:

   • "Generate a Python script to parse CSV data and output JSON."
   • "Analyze my_script.py for potential bugs and suggest improvements."

2. File System Operations:

   • "Create a new file named 'config.yml' with port: 8080"
   • "Edit file 'public/css/style.css': Add a CSS rule for h2 elements"
   • "Move the file 'report.docx' from 'drafts' to 'final_reports'"

3. Version Control (Git):

   • "Stage the file 'src/main.java', commit with message 'feat: user auth', and push to develop"

4. Running Terminal Commands:

   • "Run the command 'npm run build'"

5. Complex Multi-Step Workflows:

   • "Update package.json to 2.5.0, add changelog entry, commit, and create git tag v2.5.0"

IMPORTANT: Always provide the working directory context using the workFolder parameter for file system or git operations.

Differences from Claude Code MCP

• Uses AIDA CLI instead of Claude CLI
• Tool name is aida_code instead of claude_code
• Uses --print flag for non-interactive output
• Working directory passed via -c flag to AIDA

Troubleshooting

• "Command not found" (aida): Ensure AIDA is installed and in your PATH. Run which aida to check.
• Permissions Issues: Make sure you've run aida --dangerously-skip-permissions at least once.
• JSON Errors from Server: If MCP_CLAUDE_DEBUG is true, set to false for normal operation.
• ESM/Import Errors: Ensure you are using Node.js v20 or later.

Testing

# Run all tests
npm test

# Run unit tests only
npm run test:unit

# Watch mode for development
npm run test:watch

Development

# Install dependencies
npm install

# Build the project
npm run build

# Start in development mode
npm run dev

License

MIT