MindMeister MCP 服务器

一个 MCP (Model Context Protocol) 服务器，用于将 Claude 连接到 MindMeister API v2，从而直接从 Claude Desktop 或 Claude Code 实现 AI 驱动的思维导图管理。

什么是 MCP？

MCP 是一项开放标准，允许像 Claude 这样的 AI 助手与外部工具和服务进行交互。此服务器将 MindMeister 操作公开为 MCP 工具，Claude 可以在对话期间调用这些工具。

可用工具

工具	描述
`mindmeister_get_user`	获取已认证用户的个人资料
`mindmeister_get_map`	获取特定导图的元数据 (JSON)
`mindmeister_list_maps`	分页列出导图
`mindmeister_export_map`	将导图导出为 PDF、DOCX、PPTX、RTF 或图像
`mindmeister_get_map_image`	获取导图的图像/缩略图
`mindmeister_list_rights`	列出导图的共享权限
`mindmeister_get_preferences`	获取用户偏好设置

先决条件

Python 3.10+
拥有 API 访问权限的 MindMeister 账户
来自 MindMeister 的个人访问令牌 (Personal Access Token)

获取 API 令牌

登录 MindMeister
前往 账户 (Account) → API → 个人访问令牌 (Personal Access Tokens)
创建一个具有所需范围的新令牌：
- mindmeister.readonly — 用于只读访问
- mindmeister — 用于完全访问
复制令牌

安装

选项 1：从源码安装

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

选项 2：直接从 GitHub 安装

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

选项 3：手动设置

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

配置

将您的 MindMeister API 令牌设置为环境变量：

export MINDMEISTER_API_TOKEN="your_personal_access_token_here"

或者根据 .env.example 创建一个 .env 文件：

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

在 Claude Desktop 中使用

将其添加到您的 claude_desktop_config.json 中：

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

如果您使用 pip install -e . 安装，也可以使用：

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

配置文件位置

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

在 Claude Code 中使用

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

然后在运行 Claude Code 之前设置环境变量：

export MINDMEISTER_API_TOKEN="your_token"
claude

对话示例

配置完成后，您可以询问 Claude 如下内容：

“显示我的 MindMeister 导图”
“获取导图 1234567890 的详细信息”
“将导图 1234567890 导出为 PDF”
“谁有权访问导图 1234567890？”
“我的 MindMeister 账户详情是什么？”

开发

# 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

项目结构

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

API 覆盖范围

此服务器针对 MindMeister API v2 (https://www.mindmeister.com/api/v2/)。涵盖了以下端点：

GET /users/me — 用户个人资料
GET /maps/{id} — 导图元数据
GET /maps — 列出导图
GET /maps/{id} (带 Accept 标头) — 导出为 PDF/DOCX/PPTX/RTF/图像
GET /map_images/{id} — 导图图像
GET /maps/{id}/rights — 导图权限
GET /users/me/preferences — 用户偏好设置

许可证

MIT

Install Server

A

license - permissive license

A

quality

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

MindMeister MCP Server