CodeAlive MCP: Deepest Context Engine for your projects (especially for large codebases)

Connect your AI assistant to CodeAlive's powerful code understanding platform in seconds!

This MCP (Model Context Protocol) server enables AI clients like Claude Code, Cursor, Claude Desktop, Continue, VS Code (GitHub Copilot), Cline, Codex, OpenCode, Qwen Code, Gemini CLI, Roo Code, Goose, Kilo Code, Windsurf, Kiro, Qoder, n8n, and Amazon Q Developer to access CodeAlive's advanced semantic code search and codebase interaction features.

What is CodeAlive?

The most accurate and comprehensive Context Engine as a service, optimized for large codebases, powered by advanced GraphRAG and accessible via MCP. It enriches the context for AI agents like Cursor, Claude Code, Codex, etc., making them 35% more efficient and up to 84% faster.

It's like Context7, but for your (large) codebases.

It allows AI-Coding Agents to:

• Find relevant code faster with semantic search

• Understand the bigger picture beyond isolated files

• Provide better answers with full project context

• Reduce costs and time by removing guesswork

Related MCP server: Codebase MCP

🛠 Available Tools

Once connected, you'll have access to these powerful tools:

1. get_data_sources - List your indexed repositories and workspaces

2. codebase_search - Semantic code search across your indexed codebase (main/master branch)

3. codebase_consultant - AI consultant with full project expertise

🎯 Usage Examples

After setup, try these commands with your AI assistant:

• "Show me all available repositories" → Uses get_data_sources

• "Find authentication code in the user service" → Uses codebase_search

• "Explain how the payment flow works in this codebase" → Uses codebase_consultant

Table of Contents

• Quick Start (Remote)

• AI Client Integrations

• Advanced: Local Development

• Community Plugins

• HTTP Deployment (Self-Hosted & Cloud)

• Available Tools

• Usage Examples

• Troubleshooting

• License

🚀 Quick Start (Remote)

The fastest way to get started - no installation required! Our remote MCP server at https://mcp.codealive.ai/api provides instant access to CodeAlive's capabilities.

Step 1: Get Your API Key

1. Sign up at https://app.codealive.ai/

2. Navigate to MCP & API

3. Click "+ Create API Key"

4. Copy your API key immediately - you won't see it again!

Step 2: Choose Your AI Client

Select your preferred AI client below for instant setup:

🚀 Quick Start (Agentic Installation)

You may ask your AI agent to install the CodeAlive MCP server for you.

1. Copy-Paste the following prompt into your AI agent (remember to insert your API key):

Then allow execution.

2. Restart your AI agent.

🤖 AI Client Integrations

Option 1: Remote HTTP (Recommended)

Option 2: Docker (STDIO)

Replace YOUR_API_KEY_HERE with your actual API key.

Option 1: Remote HTTP (Recommended)

1. Open Cursor → Settings (Cmd+, or Ctrl+,)

2. Navigate to "MCP" in the left panel

3. Click "Add new MCP server"

4. Paste this configuration:

5. Save and restart Cursor

Option 2: Docker (STDIO)

OpenAI Codex CLI supports MCP via ~/.codex/config.toml.

~/.codex/config.toml

Experimental: Streamable HTTP (requires experimental_use_rmcp_client)

Note: Streamable HTTP support requires enabling the experimental Rust MCP client in your Codex configuration.

One command setup (complete):

Replace YOUR_API_KEY_HERE with your actual API key. That's it - no config files needed! 🎉

Option 1: Remote HTTP (Recommended)

1. Create/edit .continue/config.yaml in your project or ~/.continue/config.yaml

2. Add this configuration:

3. Restart VS Code

Option 2: Docker (STDIO)

Option 1: Remote HTTP (Recommended)

Note: VS Code supports both Streamable HTTP and SSE transports, with automatic fallback to SSE if Streamable HTTP fails.

1. Open Command Palette (Ctrl+Shift+P or Cmd+Shift+P)

2. Run "MCP: Add Server"

3. Choose "HTTP" server type

4. Enter this configuration:

5. Restart VS Code

Option 2: Docker (STDIO)

Create .vscode/mcp.json in your workspace:

Note: Claude Desktop remote MCP requires OAuth authentication. Use Docker option for Bearer token support.

Docker (STDIO)

1. Edit your config file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this configuration:

3. Restart Claude Desktop

Option 1: Remote HTTP (Recommended)

1. Open Cline extension in VS Code

2. Click the MCP Servers icon to configure

3. Add this configuration to your MCP settings:

4. Save and restart VS Code

Option 2: Docker (STDIO)

Add CodeAlive as a remote MCP server in your opencode.json.

Qwen Code supports MCP via mcpServers in its settings.json and multiple transports (stdio/SSE/streamable-http). Use streamable-http when available; otherwise use Docker (stdio).

~/.qwen/settings.json

Fallback: Docker (stdio)

Roo Code reads a JSON settings file similar to Cline.

Global config: mcp_settings.json (Roo) or cline_mcp_settings.json (Cline-style)

Option A — Remote HTTP

Option B — Docker (STDIO)

Tip: If your Roo build doesn't honor HTTP headers, use the Docker/STDIO option.

UI path: Settings → MCP Servers → Add → choose Streamable HTTP

Streamable HTTP configuration:

• Name: codealive

• Endpoint URL: https://mcp.codealive.ai/api

• Headers: Authorization: Bearer YOUR_API_KEY_HERE

Docker (STDIO) alternative:

Add a STDIO extension with:

• Command: docker

• Args: run --rm -i -e CODEALIVE_API_KEY=YOUR_API_KEY_HERE ghcr.io/codealive-ai/codealive-mcp:v0.3.0

UI path: Manage → Integrations → Model Context Protocol (MCP) → Add Server

HTTP

STDIO (Docker)

File: ~/.codeium/windsurf/mcp_config.json

Note: Kiro does not yet support remote MCP servers natively. Use the mcp-remote workaround to connect to remote HTTP servers.

Prerequisites:

UI path: Settings → MCP → Add Server

Global file: ~/.kiro/settings/mcp.json Workspace file: .kiro/settings/mcp.json

Remote HTTP (via mcp-remote workaround)

Docker (STDIO)

UI path: User icon → Qoder Settings → MCP → My Servers → + Add (Agent mode)

SSE (remote HTTP)

STDIO (Docker)

Q Developer CLI

Config file: ~/.aws/amazonq/mcp.json or workspace .amazonq/mcp.json

HTTP server

STDIO (Docker)

Q Developer IDE (VS Code / JetBrains)

Global: ~/.aws/amazonq/agents/default.json Local (workspace): .aws/amazonq/agents/default.json

Minimal entry (HTTP):

Use the IDE UI: Q panel → Chat → tools icon → Add MCP Server → choose http or stdio.

Note: JetBrains AI Assistant requires the mcp-remote workaround for connecting to remote HTTP MCP servers.

Prerequisites:

Config file: Settings/Preferences → AI Assistant → Model Context Protocol → Configure

Add this configuration:

For self-hosted deployments, replace the URL:

See JetBrains MCP Documentation for more details.

Using AI Agent Node with MCP Tools

1. Add an AI Agent node to your workflow

2. Configure the agent with MCP tools:

   Server URL: https://mcp.codealive.ai/api Authorization Header: Bearer YOUR_API_KEY_HERE

3. The server automatically handles n8n's extra parameters (sessionId, action, chatInput, toolCallId)

4. Use the three available tools:

   • get_data_sources - List available repositories

   • codebase_search - Search code semantically

   • codebase_consultant - Ask questions about code

Example Workflow:

Note: n8n middleware is built-in, so no special configuration is needed. The server will automatically strip n8n's extra parameters before processing tool calls.

🔧 Advanced: Local Development

For developers who want to customize or contribute to the MCP server.

Prerequisites

• Python 3.11+

• uv (recommended) or pip

Installation

Local Server Configuration

Once installed locally, configure your AI client to use the local server:

Claude Code (Local)

Other Clients (Local)

Replace the Docker command and args with:

Running HTTP Server Locally

Testing Your Local Installation

After making changes, quickly verify everything works:

The smoke test verifies:

• Server starts and connects correctly

• All tools are registered

• Each tool responds appropriately

• Parameter validation works

• Runs in ~5 seconds

Smithery Installation

Auto-install for Claude Desktop via Smithery:

🌐 Community Plugins

Gemini CLI — CodeAlive Extension

Repo: https://github.com/akolotov/gemini-cli-codealive-extension

Gemini CLI extension that wires CodeAlive into your terminal with prebuilt slash commands and MCP config. It includes:

• GEMINI.md guidance so Gemini knows how to use CodeAlive tools effectively

• Slash commands: /codealive:chat, /codealive:find, /codealive:search

• Easy setup via Gemini CLI's extension system

Install

Configure

🚢 HTTP Deployment (Self-Hosted & Cloud)

Deploy the MCP server as an HTTP service for team-wide access or integration with self-hosted CodeAlive instances.

Deployment Options

The CodeAlive MCP server can be deployed as an HTTP service using Docker. This allows multiple AI clients to connect to a single shared instance, and enables integration with self-hosted CodeAlive deployments.

Docker Compose (Recommended)

Create a docker-compose.yml file based on our example:

Configuration Options:

1. For CodeAlive Cloud (default):

   • Remove CODEALIVE_BASE_URL environment variable (uses default https://app.codealive.ai)

   • Clients must provide their API key via Authorization: Bearer YOUR_KEY header

2. For Self-Hosted CodeAlive:

   • Set CODEALIVE_BASE_URL to your CodeAlive instance URL (e.g., https://codealive.yourcompany.com)

   • Clients must provide their API key via Authorization: Bearer YOUR_KEY header

See docker-compose.example.yml for the complete configuration template.

Connecting AI Clients to Your Deployed Instance

Once deployed, configure your AI clients to use your HTTP endpoint:

Claude Code:

VS Code:

Cursor / Other Clients:

Replace your-server:8000 with your actual deployment URL and port.

🐞 Troubleshooting

Quick Diagnostics

1. Test the hosted service:

   curl https://mcp.codealive.ai/health

2. Check your API key:

   curl -H "Authorization: Bearer YOUR_API_KEY" https://app.codealive.ai/api/v1/data_sources

3. Enable debug logging: Add --debug to local server args

Common Issues

• "Connection refused" → Check internet connection

• "401 Unauthorized" → Verify your API key

• "No repositories found" → Check API key permissions in CodeAlive dashboard

• Client-specific logs → See your AI client's documentation for MCP logs

Getting Help

• 📧 Email: support@codealive.ai

• 🐛 Issues: GitHub Issues

📄 License

MIT License - see LICENSE file for details.

Ready to supercharge your AI assistant with deep code understanding?
Get started now →