nano-tech-diagrams-mcp

MCP server for creating tech diagrams using Nano Banana 2 (via Fal AI).

Supports text-to-image, image-to-image, whiteboard cleanup, and 28+ visual style presets.

Key design choice

Every image generation returns both the fal.media URL and inline base64 image data. This means the server works correctly whether it runs locally or on a remote host (VM, container) — the calling agent always receives the image directly, and also has the URL available for curl download if needed.

Tools

| Tool | Description | |------|-------------| | text_to_image | Generate a diagram from a text description | | image_to_image | Transform an existing image into a styled diagram | | whiteboard_cleanup | Clean up a whiteboard photo into a polished diagram | | list_styles | List all 28+ visual style presets | | list_diagram_types | List all diagram type presets |

Environment

Requires a Fal AI API key:

FAL_KEY=your-key-here

Or FAL_AI_API_KEY as an alternative.

Install

npm install
npm run build

Usage with Claude Code

{
  "mcpServers": {
    "nano-tech-diagrams": {
      "command": "node",
      "args": ["/path/to/nano-tech-diagrams-mcp/dist/mcp-server.js"],
      "env": {
        "FAL_KEY": "your-key"
      }
    }
  }
}

npm

npx nano-tech-diagrams-mcp

License

MIT