xmind-mcp
by hhtczengjing
README.md
# xmind-mcp
一个用于解析和搜索 XMind 思维导图文件(.xmind)的 Model Context Protocol (MCP) 服务器。可以让 Claude 及其他 AI 应用高效地提取、搜索和处理思维导图数据,并支持 token 感知的格式化和智能错误处理。
## 快速开始
在 Claude Desktop 等客户端的配置中添加:
```json
{
"mcpServers": {
"xmind-mcp": {
"command": "npx",
"args": [
"-y",
"@zengjing/xmind-mcp"
]
}
}
}
```
## 开发
### 构建
将 TypeScript 编译为 JavaScript:
```bash
npm run build
```
不构建,仅做类型检查:
```bash
npm run lint
```TDQS
A4.3/5.0
Scored across 3 tools
Disambiguation5/5
Each tool has a clearly distinct purpose: parse the entire document, search nodes by keyword, and extract a specific branch. No ambiguity between these operations.
Naming Consistency5/5
All tool names follow the consistent verb_noun snake_case pattern (parse_xmind, search_xmind_nodes, get_xmind_node_branch), making the API predictable.
Tool Count5/5
Three tools is a well-scoped count for an XMind reading/exploration server. Each tool serves a distinct need without redundancy.
Completeness5/5
The tool set covers the full read-side lifecycle: full-document parsing, keyword search, and subtree extraction. There are no obvious gaps for the apparent purpose of exploring XMind files.
Maintenance
ActivityMaintained
ResponsivenessNo issues