@getnella/mcp

Unified CLI and MCP Server for AI agent reliability

Nella provides codebase indexing, hybrid search, and context tracking for AI coding agents via MCP (Model Context Protocol).

Installation

# Global installation
npm install -g @getnella/mcp

# Or use with npx
npx @getnella/mcp --help

# As a dev dependency
npm install -D @getnella/mcp

Quick Start

MCP Server (for Claude Desktop)

# Start MCP server
nella mcp --workspace /path/to/project

Index Your Codebase

# Index for search
nella index --force

Playground Server

# Start playground with real-time dashboard
nella playground --workspace /path/to/project

# With custom port
nella playground --workspace /path/to/project --port 4000

Open http://localhost:3847 to view the dashboard with:

• Real-time tool call monitoring
• Chain of thought visualization
• Cost tracking (tokens + estimated $)
• Session management

Commands

nella index

Index workspace for semantic and lexical search.

nella index [--force]

nella mcp

Start an MCP server for AI agent integration.

nella mcp [--workspace <path>]

nella playground

Start the playground server with a real-time dashboard.

nella playground [--workspace <path>] [--port <number>] [--host <host>]

nella connect

Configure MCP clients.

nella connect --client claude|vscode|cursor|all [--server-url <url>] [--api-key <key>]

nella auth

Authentication management.

nella auth login|logout|status

MCP Integration

Claude Desktop Setup

Add to your Claude Desktop config:

macOS/Linux (~/.config/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "nella": {
      "command": "npx",
      "args": ["@getnella/mcp", "--workspace", "/path/to/project"]
    }
  }
}

Available MCP Tools

CLI Options

Programmatic Usage

import {
  ContextManager,
  createIndexManager,
  IndexManager,
} from '@getnella/mcp';

// MCP server
import { startMcpServer } from '@getnella/mcp/mcp';

Core Modules (Re-exported)

@getnella/mcp re-exports key modules from @usenella/core:

• Indexing & search (RAG)
• Context tracking (assumptions, dependencies)
• Workspace management
• Auth + rate limiting
• Cloud sync (GCS)
• Playground server

See the Core Modules guide for examples.

Exit Codes

Related Packages

• @usenella/core - Core library
• @usenella/benchmark - Benchmarking tools

Documentation

Full documentation available at:

• CLI Commands
• MCP Integration
• Core API Reference
• Core Modules

License

MIT © Nella Labs