Servidor MCP de MindMeister

Un servidor MCP (Model Context Protocol) que conecta Claude a la API v2 de MindMeister, permitiendo la gestión de mapas mentales impulsada por IA directamente desde Claude Desktop o Claude Code.

¿Qué es MCP?

MCP es un estándar abierto que permite a los asistentes de IA como Claude interactuar con herramientas y servicios externos. Este servidor expone las operaciones de MindMeister como herramientas MCP que Claude puede invocar durante las conversaciones.

Herramientas disponibles

Requisitos previos

• Python 3.10+

• Una cuenta de MindMeister con acceso a la API

• Un token de acceso personal (Personal Access Token) de MindMeister

Cómo obtener tu token de API

1. Inicia sesión en MindMeister

2. Ve a Cuenta → API → Tokens de acceso personal

3. Crea un nuevo token con los alcances (scopes) que necesites:

   • mindmeister.readonly — para acceso de solo lectura

   • mindmeister — para acceso completo

4. Copia el token

Instalación

Opción 1: Instalar desde el código fuente

git clone https://github.com/conexaoarteiro/mindmeister-mcp.git
cd mindmeister-mcp
pip install -e .

Opción 2: Instalar directamente desde GitHub

pip install git+https://github.com/conexaoarteiro/mindmeister-mcp.git

Opción 3: Configuración manual

git clone https://github.com/conexaoarteiro/mindmeister-mcp.git
cd mindmeister-mcp
pip install -r requirements.txt

Configuración

Establece tu token de API de MindMeister como una variable de entorno:

export MINDMEISTER_API_TOKEN="your_personal_access_token_here"

O crea un archivo .env basado en .env.example:

cp .env.example .env
# Edit .env and add your token

Uso con Claude Desktop

Añade esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "mindmeister": {
      "command": "python",
      "args": ["-m", "mindmeister_mcp.server"],
      "env": {
        "MINDMEISTER_API_TOKEN": "your_personal_access_token_here"
      }
    }
  }
}

Si instalaste con pip install -e ., también puedes usar:

{
  "mcpServers": {
    "mindmeister": {
      "command": "mindmeister-mcp",
      "env": {
        "MINDMEISTER_API_TOKEN": "your_personal_access_token_here"
      }
    }
  }
}

Ubicación del archivo de configuración

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Uso con Claude Code

claude mcp add mindmeister -- python -m mindmeister_mcp.server

Luego, establece la variable de entorno antes de ejecutar Claude Code:

export MINDMEISTER_API_TOKEN="your_token"
claude

Ejemplos de conversaciones

Una vez configurado, puedes pedirle a Claude cosas como:

• "Muéstrame mis mapas de MindMeister"

• "Obtén los detalles del mapa 1234567890"

• "Exporta el mapa 1234567890 como PDF"

• "¿Quién tiene acceso al mapa 1234567890?"

• "¿Cuáles son los detalles de mi cuenta de MindMeister?"

Desarrollo

# Clone and install in dev mode
git clone https://github.com/conexaoarteiro/mindmeister-mcp.git
cd mindmeister-mcp
pip install -e ".[dev]"

# Run the server directly
python -m mindmeister_mcp.server

Estructura del proyecto

mindmeister-mcp/
├── README.md
├── pyproject.toml
├── requirements.txt
├── .env.example
├── .gitignore
└── src/
    └── mindmeister_mcp/
        ├── __init__.py
        ├── server.py      # FastMCP server with all tools
        ├── client.py       # Async HTTP client for MindMeister API v2
        └── models.py       # Pydantic input validation models

Cobertura de la API

Este servidor apunta a la API v2 de MindMeister (https://www.mindmeister.com/api/v2/). Se cubren los siguientes endpoints:

• GET /users/me — perfil de usuario

• GET /maps/{id} — metadatos del mapa

• GET /maps — listar mapas

• GET /maps/{id} (con encabezado Accept) — exportar como PDF/DOCX/PPTX/RTF/imagen

• GET /map_images/{id} — imagen del mapa

• GET /maps/{id}/rights — permisos del mapa

• GET /users/me/preferences — preferencias del usuario

Licencia

MIT