MCP Server

The MCP (Model Context Protocol) server connects noodlbox to AI assistants like Claude and Cursor, enabling intelligent code exploration and analysis.

What is MCP?

MCP is a protocol that allows AI assistants to access external tools and data. The noodlbox MCP server exposes the knowledge graph through:

• Tools - Execute operations like queries and searches
• Resources - Access structured data like maps and schemas

Quick Setup

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

Full setup guide

Tools

The MCP server provides three tools for interacting with noodlbox:

Resources

Access structured data through MCP resources:

Tools vs Resources

Use Tools when:

• You need custom queries
• Searching for specific patterns
• Analyzing changes or impact
• Complex graph traversals

Use Resources when:

• You need structured, predefined data
• Exploring standard views
• Building on consistent responses

Example Workflow

1. List repositories - Find available repos with the repositories resource
2. View the map - Get an overview with the codebase map resource
3. Explore communities - Dive into specific areas
4. Query details - Use Cypher for specific questions
5. Analyze impact - Check changes before committing

Security

All MCP operations are:

• Read-only - Cannot modify code or graph
• Authenticated - Requires valid API key
• Logged - All queries are auditable

Learn More

• Setup Guide - Installation and configuration