Mcp Xmind Server

Visão geral

O que é mcp-xmind?

mcp-xmind é um repositório público hospedado no GitHub, criado pelo usuário apeyroux. Este repositório foi projetado para facilitar o uso do XMind, uma ferramenta popular de mapeamento mental e brainstorming. O projeto tem como objetivo fornecer aos usuários funcionalidades e recursos aprimorados que melhoram sua experiência ao usar o XMind para organizar pensamentos, ideias e projetos.

Recursos do mcp-xmind

Interface Amigável: mcp-xmind oferece uma interface limpa e intuitiva que facilita a navegação e a utilização eficaz de seus recursos pelos usuários.
Ferramentas Avançadas de Mapeamento Mental: O repositório inclui ferramentas avançadas para criar e gerenciar mapas mentais, permitindo que os usuários visualizem suas ideias de forma mais clara.
Recursos de Colaboração: Os usuários podem colaborar em tempo real, facilitando o trabalho em projetos com membros da equipe ou compartilhando ideias com outros.
Compatibilidade entre Plataformas: mcp-xmind foi projetado para funcionar perfeitamente em diferentes sistemas operacionais, garantindo que os usuários possam acessar seus mapas mentais de qualquer dispositivo.
Modelos Personalizáveis: O repositório fornece uma variedade de modelos que os usuários podem personalizar para atender às suas necessidades específicas, facilitando o início do mapeamento mental.

Como Usar o mcp-xmind

Acesse o Repositório: Visite a página do GitHub do mcp-xmind para acessar os arquivos do projeto e a documentação.
Clone o Repositório: Use o Git para clonar o repositório para sua máquina local executando o comando:
```
git clone https://github.com/apeyroux/mcp-xmind.git
```
Instale as Dependências: Siga as instruções de instalação fornecidas no arquivo README do repositório para configurar as dependências necessárias.
Comece a Usar o Aplicativo: Inicie o aplicativo e comece a criar seus mapas mentais usando as ferramentas e recursos disponíveis.
Colabore e Compartilhe: Convide membros da equipe para colaborar em seus mapas mentais e compartilhe seus projetos com outros para feedback e sugestões.

Perguntas Frequentes

Q: O mcp-xmind é gratuito para usar?

A: Sim, o mcp-xmind é um repositório público e é gratuito para qualquer pessoa interessada em mapeamento mental.

Q: Posso contribuir para o projeto mcp-xmind?

A: Absolutamente! Contribuições são bem-vindas. Você pode fazer um fork do repositório, fazer suas alterações e enviar um pull request para revisão.

Q: Quais plataformas o mcp-xmind suporta?

A: mcp-xmind foi projetado para ser multiplataforma, o que significa que pode ser usado em sistemas operacionais Windows, macOS e Linux.

Q: Onde posso encontrar suporte se encontrar problemas?

A: Você pode verificar a seção de problemas do repositório GitHub do mcp-xmind para problemas existentes ou relatar um novo problema se precisar de assistência.

Detalhe

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

read_xmind
- Parse and analyze XMind files
- Extract complete mind map structure
get_todo_tasks
- Extract and analyze TODO tasks
- Include task context and hierarchy
list_xmind_directory
- Recursively scan for XMind files
- Filter and organize results
read_multiple_xmind_files
- Process multiple files simultaneously
- Compare and analyze across files
search_xmind_files
- Search files by name patterns
- Recursive directory scanning
extract_node
- Smart fuzzy path matching
- Ranked search results
- Complete subtree extraction
extract_node_by_id
- Direct node access by ID
- Fast and precise retrieval
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

{ "mcpServers": { "mcp-xmind": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/metorial/mcp-container--apeyroux--mcp-xmind--mcp-xmind", "node dist/index.js" ], "env": {} } } }