ikuncode-aimcp - Unified AI MCP Server ​

One binary, three AI engines — Gemini · Codex · Grok

🔗 Related Links ​

✨ Features ​

• ✅ One binary, all the tools: Configure a single MCP server instead of three separate installations
• ✅ Runtime detection: Detects available tools on startup and returns clear errors for anything unavailable
• ✅ AdaptiveStdio transport: Auto-detects JSONL and LSP frame formats for maximum client compatibility
• ✅ Pure-Rust GrokSearch: Zero Python dependencies — web search and content fetching via the Grok API
• ✅ Gemini image generation: Built-in gemini_image tool with aspect ratio and resolution control

🧰 Tool List ​

Related Projects ​

🛠️ Installation ​

Option 1: Download a prebuilt binary (recommended) ​

Grab the binary for your platform from GitHub Releases:

Drop the binary into a directory on your PATH. On macOS / Linux, mark it executable first:

chmod +x ikuncode-aimcp-*
mv ikuncode-aimcp-* /usr/local/bin/ikuncode-aimcp

Option 2: Install via npm ​

npm install -g ikuncode-aimcp

Option 3: Install via cargo ​

cargo install --git https://github.com/xuxu777xu/ikuncode-aimcp.git

Option 4: Build from source ​

git clone https://github.com/xuxu777xu/ikuncode-aimcp.git
cd ikuncode-aimcp
cargo build --release
# Binary is in the target/release/ directory

⚙️ Configure Your MCP Client ​

Add the following block to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "ikuncode-aimcp": {
      "command": "ikuncode-aimcp",
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key",
        "GROK_API_KEY": "your-grok-api-key"
      }
    }
  }
}

📖 Tool Reference ​

gemini — AI task execution ​

gemini_image — image generation ​

codex — AI-assisted coding ​

web_search — web search ​

web_fetch — web content fetcher ​

get_config_info — Grok config diagnostics ​

No parameters. Returns the current Grok configuration and tests the API connection.

FAQ ​

Command not found after install? ​

Verify the binary is on your PATH and marked executable. Run which ikuncode-aimcp to check.

Gemini tools unavailable? ​

Confirm that GEMINI_API_KEY is set correctly and that Gemini CLI is installed locally.

Grok search returns an error? ​

Run the get_config_info tool to inspect your API configuration and connection status.

More questions? ​

See the FAQ or contact after-sales support.