Skip to main content
Glama

xmind-mcp

一个用于解析和搜索 XMind 思维导图文件(.xmind)的 Model Context Protocol (MCP) 服务器。可以让 Claude 及其他 AI 应用高效地提取、搜索和处理思维导图数据,并支持 token 感知的格式化和智能错误处理。

快速开始

在 Claude Desktop 等客户端的配置中添加:

{
  "mcpServers": {
    "xmind-mcp": {
      "command": "npx",
      "args": [
        "-y", 
        "@zengjing/xmind-mcp"
      ]
    }
  }
}

Related MCP server: XMind Generator MCP

开发

构建

将 TypeScript 编译为 JavaScript:

npm run build

不构建,仅做类型检查:

npm run lint

Available Tools

3 tools
get_xmind_node_branchA

Extract a specific node and its subtree (up to specified depth) from an XMind file. Useful for large mind maps to avoid token overload by retrieving only relevant branches.

Inputs: path (required), nodeId (required), depth.

parse_xmindA

Parse an entire XMind document (.xmind file) and return formatted output (Markdown or JSON). Markdown format is more token-efficient and recommended for large documents. JSON format includes structure summary and detailed metadata. Supports both Zen (modern) and Legacy (XMind 8) formats.

Inputs: path (required), format.

search_xmind_nodesA

Search for nodes in an XMind file by keyword (title/notes) or label. Returns matching nodes with breadcrumb paths. Useful for large mind maps to find specific topics without loading entire document.

Inputs: path (required), query (required), searchIn, caseSensitive.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: parse the entire document, search nodes by keyword, and extract a specific branch. No ambiguity between these operations.

    Naming Consistency5/5

    All tool names follow the consistent verb_noun snake_case pattern (parse_xmind, search_xmind_nodes, get_xmind_node_branch), making the API predictable.

    Tool Count5/5

    Three tools is a well-scoped count for an XMind reading/exploration server. Each tool serves a distinct need without redundancy.

    Completeness5/5

    The tool set covers the full read-side lifecycle: full-document parsing, keyword search, and subtree extraction. There are no obvious gaps for the apparent purpose of exploring XMind files.

    Related MCP Connectors

    Related MCP Servers