MCP Setup

The MCP (Model Context Protocol) server is the primary way to access noodlbox from AI assistants like Claude. This guide covers installation and configuration.

Installation

Claude Desktop

Add the noodlbox MCP server to your Claude Desktop configuration:

{
  "mcpServers": {
    "noodlbox": {
      "command": "npx",
      "args": ["-y", "@noodlbox/mcp-server"],
      "env": {
        "NOODLBOX_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Configure in your Cursor settings:

{
  "mcp": {
    "servers": {
      "noodlbox": {
        "command": "npx",
        "args": ["-y", "@noodlbox/mcp-server"],
        "env": {
          "NOODLBOX_API_KEY": "your-api-key"
        }
      }
    }
  }
}

Configuration

Environment Variables

Variable	Required	Description
`NOODLBOX_API_KEY`	Yes	Your noodlbox API key
`NOODLBOX_DEFAULT_REPO`	No	Default repository to query

Getting Your API Key

Sign in to noodlbox.io
Navigate to Settings > API Keys
Create a new API key
Copy and use in your configuration

Verifying Setup

Once configured, test the connection by asking your AI assistant:

"List my noodlbox repositories"

You should see a list of repositories you have access to.

Available Tools

The MCP server provides three tools:

Tool	Description
Cypher Query	Execute graph queries against the knowledge graph
Context Search	Find relevant code with context-aware search
Impact Detection	Analyze git changes to understand impact

Learn more about MCP tools