MCP 服务器

mmap-mcp-server

Enables AI assistants to read, search, and convert MindManager .mmap files without installing MindManager.

README

mmap MCP Server

一個讓 AI 助理可以讀取、搜尋、轉換 MindManager .mmap 檔案的本地 MCP Server。

不需要安裝 MindManager，直接解析 .mmap 原始檔案格式。

🛠️ 提供的工具

工具	說明
`read_mmap`	讀取 .mmap 並回傳完整 JSON 結構
`mmap_to_markdown`	將 .mmap 轉換為 Markdown 大綱
`search_mmap`	搜尋包含關鍵字的節點
`mmap_stats`	回傳節點數、深度等統計資訊

⚙️ 安裝步驟

1. 複製專案

git clone <本專案的 Git 網址>
cd mmap-mcp-server

2. 建立虛擬環境並安裝相依套件

需要 Python 3.10 以上版本。

Windows：

python -m venv .venv
.venv\Scripts\pip.exe install fastmcp

macOS / Linux：

python3 -m venv .venv
.venv/bin/pip install fastmcp

3. 設定 MCP

在您的 AI 工具的 MCP 設定檔中加入（請調整路徑）：

Windows：

{
  "mcpServers": {
    "mmap-reader": {
      "command": "C:/path/to/mmap-mcp-server/.venv/Scripts/python.exe",
      "args": ["C:/path/to/mmap-mcp-server/server.py"]
    }
  }
}

macOS / Linux：

{
  "mcpServers": {
    "mmap-reader": {
      "command": "/path/to/mmap-mcp-server/.venv/bin/python",
      "args": ["/path/to/mmap-mcp-server/server.py"]
    }
  }
}

Antigravity IDE 設定範例（本機）：

{
  "mcpServers": {
    "mmap-reader": {
      "command": "d:/git/mmap-mcp-server/.venv/Scripts/python.exe",
      "args": ["d:/git/mmap-mcp-server/server.py"]
    }
  }
}

4. 重新啟動 AI 工具

重啟後，AI 即可使用 mmap 相關工具。

🚀 使用範例

設定完成後，您可以對 AI 說：

幫我讀取 D:\projects\設計.mmap 的內容

搜尋 D:\projects\設計.mmap 裡面所有包含「管理」的節點

把 D:\projects\設計.mmap 轉成 Markdown 格式給我

📁 專案結構

mmap-mcp-server/
├── server.py         ← MCP Server 主程式
├── mmap_parser.py    ← .mmap 解析核心（不依賴 MindManager）
├── requirements.txt  ← Python 相依套件清單
├── README.md         ← 本說明文件
└── .venv/            ← 虛擬環境（git clone 後自行建立，不需 commit）