array-flatten-unflatten

Provides tools to flatten nested arrays into a single-level array and to unflatten flattened arrays back into nested structures based on a given depth or structure.

Installation

You can use this MCP server via npx or install globally:

npx @dennisk2025/array-flatten-unflatten

or

npm install -g @dennisk2025/array-flatten-unflatten

Adding to Claude Desktop

Add this to your Claude Desktop config file at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Example configuration:

{
  "mcpServers": {
    "flatten": {
      "command": "npx",
      "args": ["@dennisk2025/array-flatten-unflatten"]
    }
  }
}

Usage

Once the MCP server is running (automatically launched by Claude Desktop or manually), you can use the following tools:

Tools

flatten-array

Description: Takes a nested array (of any depth) and returns a new array with all the elements in a single level.

Parameters:

• nested_array (array, required): The nested array to flatten.

Example call:

Tool: flatten-array
Parameters:
{
  "nested_array": [[1, 2, [3]], 4, [5, [6, [7, 8]]]]
}

Response:

{
  "result": [1, 2, 3, 4, 5, 6, 7, 8]
}

unflatten-array

Description: Takes a flat array and reconstructs a nested array structure given a nesting scheme (e.g., depths per group).

Parameters:

• flat_array (array, required): The flat array to reshape into nested structure.
• structure (array of integers, required): The blueprint for nesting (e.g. [2, 2, 2] means 2 arrays of 2 arrays of 2 items each).

Example call:

Tool: unflatten-array
Parameters:
{
  "flat_array": [1,2,3,4,5,6,7,8],
  "structure": [2,2,2]
}

Response:

{
  "result": [ [[1,2],[3,4]], [[5,6],[7,8]] ]
}

Tool List

• flatten-array

  • nested_array (array, required): The nested array to flatten

• unflatten-array

  • flat_array (array, required): The flat array to reshape
  • structure (array of integers, required): The nesting blueprint

Notes

• Returns errors if required parameters are missing or of invalid types.
• Restores original nested grouping for unflatten if the total number of items matches the product of all structure dimensions.