MCP XMind Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Supports distribution and installation through npm, allowing users to easily install and run the MCP server using npx commands.

  • Utilizes TypeScript for type safety in development, with specific support for type checking when building or modifying the MCP server.

  • Incorporates Zod for schema validation, ensuring proper data structure when processing XMind files and handling user queries.

MCP XMind 服务器

用于分析和查询 XMind 思维导图的模型上下文协议服务器。该工具提供了强大的功能,可用于搜索、提取和分析 XMind 文件的内容。

特征

  • 🔍 跨思维导图的智能模糊搜索
  • 📝 任务管理和跟踪
  • 🌲 分层内容导航
  • 🔗 链接和参考提取
  • 📊 多文件分析
  • 🏷️ 标签和标记支持
  • 📂 目录扫描
  • 🔒 安全目录访问

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 XMind 服务器:

npx -y @smithery/cli install @41px/mcp-xmind --client claude

手动安装

npm install @modelcontextprotocol/sdk adm-zip zod npm install --save-dev typescript @types/node

用法

启动服务器

node dist/index.js <allowed-directory> [additional-directories...]

可用工具

  1. read_xmind
    • 解析和分析 XMind 文件
    • 提取完整的思维导图结构
  2. 获取待办任务
    • 提取并分析TODO任务
    • 包括任务上下文和层次结构
  3. list_xmind_directory
    • 递归扫描 XMind 文件
    • 过滤和组织结果
  4. 读取多个 xmind 文件
    • 同时处理多个文件
    • 跨文件比较和分析
  5. 搜索xmind文件
    • 按名称模式搜索文件
    • 递归目录扫描
  6. 提取节点
    • 智能模糊路径匹配
    • 排名搜索结果
    • 完成子树提取
  7. 按id提取节点
    • 通过 ID 直接访问节点
    • 快速、精确的检索
  8. 搜索节点
    • 多条件内容搜索
    • 可配置的搜索字段

示例

搜索节点

{ "name": "search_nodes", "arguments": { "path": "/path/to/file.xmind", "query": "project", "searchIn": ["title", "notes"], "caseSensitive": false } }

提取节点

{ "name": "extract_node", "arguments": { "path": "/path/to/file.xmind", "searchQuery": "Feature > API" } }

列出任务

{ "name": "get_todo_tasks", "arguments": { "path": "/path/to/file.xmind" } }

配置

开发配置

用于开发的claude_desktop_config.json示例:

{ "xmind": { "command": "node", "args": [ "/Users/alex/Src/mcp-xmind/dist/index.js", "/Users/alex/XMind" ] } }

生产配置

使用 npmjs 进行生产的示例claude_desktop_config.json

{ "xmind": { "command": "npx", "args": [ "-y", "@41px/mcp-xmind", "/Users/alex/XMind" ] } }

安全

  • 仅允许访问指定目录
  • 路径规范化和验证
  • 无效访问尝试的错误处理

发展

建筑

npm run build

类型检查

npm run type-check

MCP 检查器

npx @modelcontextprotocol/inspector node dist/index.js /Users/alex/XMind
-
security - not tested
F
license - not found
-
quality - not tested

模型上下文协议服务器允许对 XMind 思维导图进行智能分析和查询,提供跨 XMind 文件搜索、提取和分析内容的功能。

  1. Features
    1. Installation
      1. Installing via Smithery
      2. Manual Installation
    2. Usage
      1. Starting the Server
      2. Available Tools
    3. Examples
      1. Search for Nodes
      2. Extract Node
      3. List Tasks
    4. Configuration
      1. Development Configuration
      2. Production Configuration
    5. Security
      1. Development
        1. Building
        2. Type Checking
        3. MCP Inspector
      ID: 4i3g9okcvy