> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scmcphub.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Code Mode

> Code mode development guide for scmcphub

# Code Mode

The code Mode depends on [abcoder](https://github.com/huang-sh/abcoder)

In code Mode, usually you don't need develop tools, because LLM generate code, and jupyter execute code.
But if you Always want to call same codes or specific code execution. You also can develop mcp tool in code mode,
just refer to tool-mode, define schemata, server, use get\_nbm to get jupyter backend.

## Overview

Code mode is designed for interactive analysis workflows where the LLM generates code that gets executed in Jupyter notebooks. This mode leverages the `NotebookManager` backend to handle multiple notebook instances with different kernels.

Additionally, it can generate complete Jupyter notebooks containing executable code, analysis results, and visualizations.

## Key Components

### NotebookManager

The `NotebookManager` is the core backend for code mode operations. It provides:

* **Multi-notebook Management**: Handle multiple Jupyter notebook instances
* **Code Execution**: Execute generated code with proper error handling
* **Notebook Persistence**: Save and load notebook states

For complete documentation, see [NotebookManager Reference](./notebook-manager.mdx).

### Backend Access

Use `get_nbm()` to access the NotebookManager in your MCP tools:

```python theme={null}
from scmcp_shared.util import get_nbm

@mcp.tool(tags=["nb"])
def execute_code(code: str):
    """Execute code in the active Jupyter notebook."""
    nbm = get_nbm()
    jce = nbm.active_notebook
    result = jce.execute(code)
    return result
```

## Development Workflow

### 1. Server Configuration

Configure your MCP server to use NotebookManager backend:

```python theme={null}
from scmcp_shared.mcp_base import BaseMCPManager
from abcoder.backend import NotebookManager
from scmcp_shared.util import get_nbm

mcp = FastMCP(name="MyAssistantServer")

@mcp.tool
def print_hello():
    nbm = get_nbm()
    jce = nbm.active_notebook
    code = "print('hello')"
    result = jce.execute(code)
    return result

class MyCodeModeManager(BaseMCPManager):
    def init_mcp(self):
        self.available_modules = {
            "nb": nb_mcp,
            "p": mcp,
        }

# Create manager with NotebookManager backend
manager = MyCodeModeManager(
    name="my-code-mcp",
    backend=NotebookManager,
    include_tags=["nb"]
)
```