Mindm MCP

🚀 MindManager MCP 服務器

mindm 庫的 Model Context Protocol (MCP) 服務器實現，支持在 Windows 和 macOS 系統上與 MindManager 進行交互。該服務器可幫助用戶更便捷地操作思維導圖，實現檢索、修改等功能。

🚀 快速開始

本服務器基於 Model Context Protocol（MCP）構建，藉助 mindm 庫提供接口，用於在 Windows 和 macOS 平臺與 MindManager 交互。下面是項目的相關信息：

• 徽章：顯示在 PyPI 上的版本信息。
• 功能：支持檢索思維導圖結構、當前選擇項等操作。

✨ 主要特性

已實現的功能

• 檢索當前思維導圖的結構
• 獲取 MindManager 中的當前選中主題
• 獲取 MindManager 庫文件夾路徑
• 提取思維導圖中的定位信息（中心主題和選定子主題）

計劃實現的功能

• 創建新的思維導圖
• 添加、刪除和修改主題及關聯項

📦 安裝指南

安裝要求

• Python 版本：需安裝 Python 3.10 或更高版本。
• 依賴庫：需要 mcp 和 mindm 庫的支持。
• MindManager 支持：支持 MindManager 的 Windows 和 macOS 版本。

安裝步驟

macOS 系統

# 克隆倉庫到本地目錄
$ mkdir -p mindmanager-mcp-server && cd $_
$ git clone https://github.com/your-repository.git .

# 創建虛擬環境並安裝依賴項
$ python3 -m venv ./.venv

# 激活虛擬環境（macOS/Linux）
$ source ./.venv/bin/activate

# 安裝項目依賴
$ pip install --editable .

Windows 系統

# 克隆倉庫到本地目錄
$ mkdir mindmanager-mcp-server && cd $_
$ git clone https://github.com/your-repository.git .

# 創建虛擬環境並安裝依賴項
$ python -m venv ./.venv

# 激活虛擬環境（Windows）
$ .\.\venv\Scripts\activate.bat

# 安裝項目依賴
$ pip install --editable .

💻 使用示例

運行 MCP 檢查工具

# 啟動 MCP 服務器
$ mindm-mcp-server start

配置 Claude Desktop 中的 MCP 服務

方法一：使用本地文件配置

在 Claude Settings 中添加以下內容到 MCP 配置文件：

{
  "servers": [
    {
      "name": "mindmanager",
      "host": "localhost",
      "port": 12345,
      "executable_path": "/path/to/MindManager"
    }
  ]
}

方法二：從包倉庫安裝模塊

在 Claude Settings 中添加以下內容到 MCP 配置文件：

{
  "servers": [
    {
      "name": "mindmanager",
      "host": "localhost",
      "port": 12345,
      "module_path": "mindmanager-mcp-server"
    }
  ]
}

📚 詳細文檔

MCP 工具

文檔交互工具

• 獲取當前思維導圖結構
• 獲取當前選中主題
• 獲取 MindManager 庫文件夾路徑
• 提取思維導圖中的定位信息

序列化工具

• 將當前思維導圖序列化為 Mermaid 格式
• 將當前思維導圖序列化為 Markdown 格式
• 將當前思維導圖序列化為 JSON 格式

平臺支持

• Windows：全面支持主題、備註、圖標、圖片、標籤、鏈接、關係和 RTF 格式。
• macOS：僅支持主題、備註和關係（功能有限）。

與 Claude 和其他 LLM 集成

此 MCP 服務器可安裝到 Claude Desktop 或其他兼容 MCP 的應用程序中，使 LLM 能夠：

1. 訪問思維導圖內容
2. 操作思維導圖（即將推出）
3. 基於 LLM 生成的內容創建新思維導圖（即將推出）

故障排除

• 確保 MindManager 已啟動後再運行服務器。
• 對於 macOS，確保 Claude Desktop 被授權自動化 MindManager。

致謝

該項目基於 mindm 庫構建，為 Windows 和 macOS 提供了訪問 MindManager 的 Python 接口。它使用 Anthropic 開發的 Model Context Protocol（MCP）SDK。

📄 許可證

MIT 許可證 - 詳細信息請參閱 LICENSE 文件