使用说明

项目简介

Este projeto implementa um servidor MCP (Model Context Protocol) simples em Python, focado na geração de instruções para criação de mapas mentais. Ele se integra ao Claude Desktop, permitindo que você utilize os modelos Claude para auxiliar na organização de ideias e estudos através de mapas mentais. O servidor oferece seis tipos de mapas mentais para diferentes finalidades, como apresentar, comparar, revisar e analisar problemas sobre um tema.

主要功能点

Geração de instruções para 6 tipos de mapas mentais:
- apresenta: Cria um mapa mental para apresentações, ideal para estruturar tópicos de forma clara e concisa.
- compara: Gera um mapa mental comparativo entre dois temas, destacando semelhanças e diferenças.
- inicial: Desenvolve um mapa mental de conhecimentos iniciais sobre um tema, útil para começar o estudo.
- intermediario: Elabora um mapa mental de conhecimentos intermediários, aprofundando a compreensão do tema.
- problemas: Cria um mapa mental para análise de problemas, ajudando a identificar causas e soluções.
- revisa: Gera um mapa mental para revisão de conteúdo, facilitando a memorização e a recapitulação.
Integração com Claude Desktop: Permite utilizar as ferramentas de mapas mentais diretamente no ambiente Claude Desktop.
Fácil instalação e configuração: Utiliza 'uv' para gerenciamento de dependências e configuração simples no Claude Desktop.

安装步骤

安装 Python: Certifique-se de ter o Python 3.10 ou superior instalado em seu sistema. Você pode baixar a versão mais recente em python.org.
安装 uv: Abra o terminal (ou prompt de comando) e execute o comando 'pip install uv'. O 'uv' é um gerenciador de pacotes Python rápido.
安装 Claude Desktop: Se ainda não tiver, instale o Claude Desktop. Você pode baixá-lo em claude.ai.
创建 pasta do projeto: Crie uma pasta para o projeto "mapas_mentais_mcp" no local de sua preferência. Você pode baixar o código fonte do repositório GitHub e extrair para esta pasta, ou clonar o repositório usando 'git clone https://github.com/marioluciofjr/mapas_mentais_mcp'.
Navegue até a pasta do projeto no terminal: Use o comando 'cd <caminho_para_a_pasta_do_projeto>' no terminal.
Crie um ambiente virtual (opcional, mas recomendado): Execute 'python -m venv .venv' para criar um ambiente virtual. Ative-o com '.venv\Scripts\activate' (no Windows) ou 'source .venv/bin/activate' (no Linux/macOS).
Instale as dependências: Execute 'uv pip install -r requirements.txt' (se houver um arquivo 'requirements.txt' no repositório) ou 'uv add mcp[cli]' para instalar o pacote 'mcp[cli]'.

服务器配置

Para utilizar este MCP Server no Claude Desktop, você precisa adicionar a seguinte configuração no arquivo 'claude_desktop_config.json' do Claude Desktop.

Abra as configurações do Claude Desktop: Com o Claude Desktop aberto, pressione 'CTRL + ,' (ou 'Cmd + ,' no macOS).
Vá para a aba "Desenvolvedor" e clique em "Editar configuração". Isso abrirá o arquivo 'claude_desktop_config.json' no seu editor de código padrão (como VSCode).
Adicione a configuração abaixo dentro da seção '"tools"' (ou crie a seção se não existir):

"mapas_mentais": {
  "command": "uv",  // Comando para executar o servidor MCP. 'uv' é usado para executar scripts Python.
  "args": [
    "run",         // Argumento para 'uv' executar um script.
    "--with",      // Argumento para 'uv' especificar dependências adicionais.
    "mcp[cli]",    // Dependência 'mcp[cli]' necessária para executar o servidor MCP.
    "mcp",         // Comando 'mcp' fornecido pelo pacote 'mcp[cli]' para executar servidores MCP.
    "server.py"   // Caminho para o arquivo 'server.py' que contém o código do servidor MCP.
                   // Certifique-se de que este caminho esteja correto em relação à localização do seu projeto mapas_mentais_mcp.
  ]
}

Observações importantes sobre a configuração:

'command': '"uv"' é utilizado como executor por ser rápido e eficiente. Se preferir usar o Python diretamente, pode usar '"python"' no lugar de '"uv run --with mcp[cli] mcp"', e ajustar os 'args' para executar 'server.py' diretamente. No entanto, a configuração com 'uv' é recomendada conforme o README do projeto.
'args': Os argumentos fornecidos em 'args' são essenciais para executar o servidor MCP corretamente usando 'uv' e o pacote 'mcp[cli]'. O caminho '"server.py"' deve ser ajustado se o seu arquivo 'server.py' estiver em um subdiretório diferente ou se você renomeou o arquivo. O caminho é relativo ao diretório raiz do projeto 'mapas_mentais_mcp'. Se você abriu a pasta raiz do projeto no VSCode ao editar 'claude_desktop_config.json', então '"server.py"' deve funcionar se 'server.py' estiver na raiz do projeto. Caso contrário, ajuste o caminho relativo corretamente.
'"mapas_mentais"': Este é o nome da ferramenta que aparecerá no Claude Desktop. Você pode alterar este nome, mas lembre-se de que ele será usado para identificar as ferramentas no Claude Desktop.
Localização do 'claude_desktop_config.json': O arquivo 'claude_desktop_config.json' está localizado no diretório de configuração do Claude Desktop. O caminho exato pode variar dependendo do seu sistema operacional. Geralmente, você pode acessá-lo facilmente através do menu de configurações do Claude Desktop como descrito nos passos acima.

Salve o arquivo 'claude_desktop_config.json' e reinicie o Claude Desktop. Feche o Claude Desktop completamente e abra-o novamente para que as alterações na configuração sejam carregadas.

基本使用方法

Abra o Claude Desktop.
Verifique se as ferramentas "mapas_mentais" foram instaladas corretamente. No canto inferior esquerdo do Claude Desktop, clique no ícone de martelo (🛠️). Se a configuração foi bem-sucedida, você deverá ver a ferramenta "mapas_mentais" listada com as seis ferramentas (apresenta, compara, inicial, intermediario, problemas, revisa).
Utilize as ferramentas de mapas mentais. Na caixa de chat do Claude Desktop, você pode invocar as ferramentas utilizando a sintaxe de ferramentas do MCP. Por exemplo, para gerar um mapa mental comparando "Python" e "JavaScript", você pode usar a seguinte instrução:

<tool_code>mapas_mentais.compara</tool_code>
<tool_code_param>tema1</tool_code_param>Python<tool_code_param>tema2</tool_code_param>JavaScript

Substitua 'mapas_mentais.compara' pelo nome da ferramenta desejada (ex: 'mapas_mentais.apresenta', 'mapas_mentais.revisa', etc.) e ajuste os parâmetros ('tema1', 'tema2', 'tema', etc.) de acordo com a ferramenta que você está utilizando e o tema desejado. O Claude irá processar sua solicitação e retornar o resultado gerado pelo servidor MCP, que neste caso, será uma instrução de mapa mental.

Observação: Este MCP Server retorna instruções para gerar mapas mentais, não os mapas mentais visuais em si. A saída do servidor é um texto formatado que descreve a estrutura e os tópicos do mapa mental. Você pode usar essas instruções como base para criar visualmente o mapa mental em ferramentas de mapas mentais como MindManager, XMind, FreeMind, ou até mesmo manualmente. O objetivo é auxiliar na estruturação do pensamento e na organização das ideias para o tema desejado.

关键词