mapify

Mapify MCP Server lets AI assistants generate interactive mind maps from a variety of content sources, including text prompts, YouTube videos, websites, and documents. Once configured in your MCP client, you can invoke tools like Text-to-Mind-Map, AI Search to Mind Map, YouTube Video Analysis, and Website Content Mapping. The server handles content ingestion, queries the Mapify platform for relevant material, and returns a beautiful mind map image along with an editable link for further customization. It also supports multi-language mind maps, making it suitable for users around the world. Typical flows include asking the assistant to create a mind map from a text idea, generate a map from a YouTube video’s content, or map the key points from a website article, with the resulting visualization and metadata provided automatically.

Prerequisites

• Node.js v16 or higher
• Access to an MCP-compatible client (for example Claude Desktop, VS Code, Cursor, Continue, etc.)
• A Mapify API key (MAPIFY_API_KEY) from your Mapify account

Option A: Use the MCP server via npx (recommended for quick start)

1. Ensure you have Node.js installed.
2. In your MCP client config, add:

{
  "mcpServers": {
    "mapify": {
      "command": "npx",
      "args": ["-y", "@xmindltd/mapify-mcp-server"],
      "env": {
        "MAPIFY_API_KEY": "your_api_token_here"
      }
    }
  }
}

Option B: Local development (build from source)

1. Clone the repository:

git clone https://github.com/xmindltd/mapify-mcp-server.git
cd mapify-mcp-server

2. Install dependencies (use npm, yarn, or pnpm as preferred; this example uses pnpm):

pnpm install

3. Build the project:

pnpm run build

4. Run the server locally (example path to built index.js):

# If you want to run directly with Node after build
node build/index.js

5. In your MCP client, configure the server to point to the local build if applicable, e.g. using a node-based path as shown in the README.

Note: Always provide MAPIFY_API_KEY in your environment when configuring the server.

Tips and considerations:

• Keep your MAPIFY_API_KEY secure; treat it like a password and do not commit it to version control.
• The MCP server can be configured in various clients; the key is to supply the command, arguments, and environment for MAPIFY_API_KEY.
• If you see connection or authentication errors, verify that the API key is valid and that your client can reach the Mapify API endpoints.
• The server supports generating both static mind map images and editable links for further customization; use the editable link when you plan to tweak the layout or add more branches.
• Ensure you’re using Node.js v16+ for compatibility with the MCP server and the client tooling.