关键词

XMind思维导图分析文件搜索知识管理任务提取

项目简介

XMind Server 是一个基于 Model Context Protocol (MCP) 的服务器应用，专门设计用于分析和查询 XMind 思维导图文件。它通过标准化的 MCP 协议与客户端通信，提供了一系列工具，使用户能够方便地从 XMind 文件中提取信息、执行搜索和进行内容分析。

主要功能点

  • XMind 文件解析: 能够解析 XMind 格式的思维导图文件，提取文件中的节点、关系、标注、任务等结构化数据。
  • 目录扫描: 可以扫描指定目录及其子目录，自动发现和索引 XMind 文件。
  • 文件搜索: 支持根据文件名或文件内容搜索 XMind 文件。
  • 节点内容搜索: 允许用户在 XMind 文件的节点标题、备注、标签等内容中进行关键词搜索。
  • 模糊路径节点提取: 支持通过模糊路径查找和提取特定的思维导图节点及其子树，方便用户快速定位和获取所需信息。
  • ID 节点提取: 可以通过节点的唯一 ID 精确提取节点及其子树。
  • 任务管理: 能够识别和提取 XMind 文件中的 TODO 任务，方便进行任务跟踪和管理。
  • 多文件处理: 支持同时处理和分析多个 XMind 文件，进行跨文件的数据分析和信息整合。
  • 安全访问控制: 仅允许服务器访问预先配置的目录，保障数据安全。

安装步骤

  1. 手动安装依赖: 在服务器端，使用 npm 安装必要的依赖包： 
    npm install @modelcontextprotocol/sdk adm-zip zod
npm install --save-dev typescript @types/node
  2. 构建项目: 如果从源码安装，需要先构建项目： 
    npm run build

服务器配置

MCP 客户端需要配置连接 XMind Server 的信息，主要是服务器的启动命令和参数。以下是一个 'claude_desktop_config.json' 的配置示例，用于配置名为 "xmind" 的服务器连接：

{
  "xmind": {
    "command": "node",
    "args": [
      "/path/to/mcp-xmind/dist/index.js",
      "/path/to/allowed/directory"
    ]
  }
}

配置参数说明:

  • 'command': 启动 XMind Server 的命令，通常为 'node'，表示使用 Node.js 运行时环境。
  • 'args': 传递给启动命令的参数数组。
    • '/path/to/mcp-xmind/dist/index.js': 请替换为实际的 'index.js' 文件在您服务器上的绝对路径。 这是 XMind Server 的主程序入口文件。
    • '/path/to/allowed/directory': 请替换为您希望允许 XMind Server 访问的根目录的绝对路径。 服务器将只能访问该目录及其子目录下的 XMind 文件。可以配置多个允许访问的目录，只需在数组中添加更多路径。

注意: MCP 客户端（如 Claude Desktop）会读取 'claude_desktop_config.json' 文件来启动和连接 MCP 服务器。请确保将上述配置添加到客户端的配置文件中，并根据实际情况修改文件路径和允许访问的目录。

基本使用方法

  1. 启动服务器: 在服务器端，根据上述配置，使用 'node dist/index.js <allowed-directory> [additional-directories...]' 命令启动 XMind Server，并指定允许访问的目录。
  2. 客户端调用: 在 MCP 客户端中，配置好服务器连接后，即可通过客户端界面或 API 调用 XMind Server 提供的工具，例如 'read_xmind', 'search_nodes', 'extract_node' 等，来分析和查询 XMind 文件。具体的工具名称、参数和使用方法可以参考仓库的 README 文档或者服务器返回的工具列表信息。

信息

分类

生产力应用

访问项目