Mcp Xmind 服务器

什么是 mcp-xmind？

mcp-xmind 是一个托管在 GitHub 上的公共代码库，由用户 apeyroux 创建。该代码库旨在促进 XMind 的使用，XMind 是一个流行的思维导图和头脑风暴工具。该项目旨在为用户提供增强的功能和特性，以改善他们在使用 XMind 组织思想、创意和项目时的体验。

mcp-xmind 的特点

• 用户友好的界面：mcp-xmind 提供了一个干净且直观的界面，使用户能够轻松导航并有效利用其功能。
• 增强的思维导图工具：该代码库包括用于创建和管理思维导图的高级工具，使用户能够更清晰地可视化他们的想法。
• 协作功能：用户可以实时协作，使团队成员更容易共同完成项目或与他人分享想法。
• 跨平台兼容性：mcp-xmind 旨在无缝地在不同操作系统上工作，确保用户可以从任何设备访问他们的思维导图。
• 可自定义模板：该代码库提供多种模板，用户可以根据自己的具体需求进行自定义，使思维导图的开始变得更加容易。

如何使用 mcp-xmind

1. 访问代码库：访问 mcp-xmind GitHub 页面 以获取项目文件和文档。
2. 克隆代码库：使用 Git 克隆代码库到本地机器，运行以下命令：

   git clone https://github.com/apeyroux/mcp-xmind.git
   

3. 安装依赖项：按照代码库 README 文件中提供的安装说明设置任何必要的依赖项。
4. 开始使用应用程序：启动应用程序，开始使用可用的工具和功能创建思维导图。
5. 协作与分享：邀请团队成员共同协作您的思维导图，并与他人分享您的项目以获取反馈和建议。

常见问题解答

问：mcp-xmind 是免费使用的吗？

答：是的，mcp-xmind 是一个公共代码库，任何对思维导图感兴趣的人都可以免费使用。

问：我可以为 mcp-xmind 项目做贡献吗？

答：当然可以！欢迎贡献。您可以分叉代码库，进行更改，并提交拉取请求以供审核。

问：mcp-xmind 支持哪些平台？

答：mcp-xmind 旨在跨平台使用，这意味着它可以在 Windows、macOS 和 Linux 操作系统上使用。

问：如果遇到问题，我可以在哪里找到支持？

答：您可以查看 mcp-xmind GitHub 代码库的问题部分，了解现有问题，或如果需要帮助，可以报告新问题。

MCP XMind Server

A Model Context Protocol server for analyzing and querying XMind mind maps. This tool provides powerful capabilities for searching, extracting, and analyzing content from XMind files.

Features

• 🔍 Smart fuzzy search across mind maps
• 📝 Task management and tracking
• 🌲 Hierarchical content navigation
• 🔗 Link and reference extraction
• 📊 Multi-file analysis
• 🏷️ Label and tag support
• 📂 Directory scanning
• 🔒 Secure directory access

Installation

Installing via Smithery

To install XMind Server for Claude Desktop automatically via Smithery:

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

Manual Installation

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

Usage

Starting the Server

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

Available Tools

1. read_xmind

   • Parse and analyze XMind files
   • Extract complete mind map structure

2. get_todo_tasks

   • Extract and analyze TODO tasks
   • Include task context and hierarchy

3. list_xmind_directory

   • Recursively scan for XMind files
   • Filter and organize results

4. read_multiple_xmind_files

   • Process multiple files simultaneously
   • Compare and analyze across files

5. search_xmind_files

   • Search files by name patterns
   • Recursive directory scanning

6. extract_node

   • Smart fuzzy path matching
   • Ranked search results
   • Complete subtree extraction

7. extract_node_by_id

   • Direct node access by ID
   • Fast and precise retrieval

8. search_nodes

   • Multi-criteria content search
   • Configurable search fields

Examples

Search for Nodes

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

Extract Node

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

List Tasks

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

Configuration

Development Configuration

Example claude_desktop_config.json for development:

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

Production Configuration

Example claude_desktop_config.json for production using npmjs:

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

Security

• Only allows access to specified directories
• Path normalization and validation
• Error handling for invalid access attempts

Development

Building

npm run build

Type Checking

npm run type-check

MCP Inspector

npx @modelcontextprotocol/inspector node dist/index.js /Users/alex/XMind