# mcp-multi-note

[![PyPI version](https://img.shields.io/pypi/v/mcp-multi-note)](https://pypi.org/project/mcp-multi-note/)
[![Python versions](https://img.shields.io/pypi/pyversions/mcp-multi-note)](https://pypi.org/project/mcp-multi-note/)
[![License](https://img.shields.io/pypi/l/mcp-multi-note)](https://github.com/Hermes-pm/mcp-multi-note/blob/master/LICENSE)

> **一个搜索框，搜你所有的笔记** — 无论笔记在飞书、Obsidian、Notion、语雀、OneNote 还是印象笔记。

你的 AI Agent（Claude Code / Cursor / Cline / Hermes）只需要一个 MCP 入口，就能搜索、读取、创建你在 **6 个平台**上的笔记。

```bash
pip install mcp-multi-note
note setup
# 配到 Agent → 完事
```

---

## 痛点

你同时在用多个笔记平台吗？

| 场景 | 现状 |
|------|------|
| Agent 想查你飞书里的笔记 | 得装飞书 MCP Server |
| 再查你 Obsidian 里的笔记 | 再装 Obsidian MCP Server |
| 再查你 Notion 的数据库 | 还得装 Notion MCP |
| ……每个平台一个工具 | 配置越来越多，入口越来越乱 |

**mcp-multi-note 解决这个问题：装一个，管所有。**

---

## 一句话

> 一个 MCP Server，飞书 / Obsidian / Notion / 语雀 / OneNote / 印象笔记全部接入。你的 Agent 们通过同一个入口搜索和读写所有笔记。

---

## 效果

Agent 可以这样跟你对话：

```
你：查一下我笔记里关于"竞品分析"的内容
Agent：→ 同时搜飞书 + Obsidian + Notion
       → 聚合结果返回给你
```

不用手动切平台、不用记多个工具的配置、不用在每个 Agent 里配好几遍。

---

## 支持的平台

| 平台 | 状态 | 配置难度 | 时间 |
|:----|:----|:--------|:----|
| **Obsidian** | ✅ 可用 | 自动 | 0 分钟 |
| **语雀** | ✅ 可用 | 简单 | 2 分钟 |
| **Notion** | ✅ 可用 | 简单 | 2 分钟 |
| **飞书** | ✅ 可用 | 中等 | 10 分钟 |
| **OneNote** | ✅ 可用 | 中等 | 15 分钟 |
| **印象笔记** | ✅ 可用 | 需审批 | 5 天 |

未配置的不会出现在 Agent 工具列表中，互不干扰。

---

## 快速开始

```bash
# 1. 安装
pip install mcp-multi-note

# 2. 运行向导（交互式配置各平台）
note setup

# 3. 配置 MCP（任选一个 Agent）
# Claude Code / Cursor / Cline → 加到 MCP 配置：
# {
#   "mcp-multi-note": {
#     "command": "note",
#     "args": ["mcp"]
#   }
# }
# Hermes → hermes config set mcp_servers.mcp-multi-note '{"command":"note","args":["mcp"]}'

# 4. 开始用（CLI 或 Agent 对话）
note search 关键词
```

---

## 核心功能

| 功能 | `note search` | Agent 调用 |
|------|------|------------|
| 搜索所有笔记 | ✅ `note search 关键词` | ✅ `{platform}_search` |
| 搜指定平台 | ✅ `--from obsidian` | ✅ 调对应 tool |
| 按时间排序 | ✅ `--sort date` | — |
| 限制数量 | ✅ `--limit 10` | — |
| 读取全文 | ✅ `note {platform} read` | ✅ `{platform}_read` |
| 创建笔记 | ✅ `note {platform} create` | ✅ `{platform}_create` |

---

## 架构

```
AI Agent (Claude Code / Cursor / Cline / Hermes / ...)
    │
    ▼  MCP stdio (JSON-RPC)
┌──────────────────────┐
│   note mcp           │  ← 一个 MCP 入口
│   tools/list/call    │
└──────┬───────────────┘
       │
┌──────▼────┐ ┌──────▼──────┐ ┌──────▼──────┐
│ Obsidian  │ │ 飞书        │ │ OneNote     │  ← 各平台独立 adapter
│ (本地文件)  │ │ (API)      │ │ (Graph API) │
└───────────┘ └─────────────┘ └─────────────┘
         ...更多平台
```

**设计原则：**
- **一个入口** — 所有 Agent 共用，只配一次
- **可插拔** — 每个平台独立 adapter，互不影响
- **零噪音** — 没配置的平台自动隐藏，不污染 tool 列表

---

## CLI 预览

```bash
# 配置向导
note setup

# 跨平台搜索
note search "API 设计"                    # 搜所有平台
note search "竞品分析" --from obsidian    # 仅 Obsidian
note search "roadmap" --from feishu,notion --sort -date --limit 10

# 单平台操作
note feishu search "关键词"
note onenote read "page-id"
note obsidian list_notebooks

# MCP 模式（给 Agent 用）
note mcp
```

---

## MCP 配置（各 Agent）

| Agent | 配置文件 | 添加方式 |
|-------|---------|---------|
| Claude Code | `~/.claude/settings.json` | 加到 `mcpServers` |
| Cursor | `~/.cursor/mcp.json` | 加到 `mcpServers` |
| Cline | `~/.cline/mcp_settings.json` | 加到 `mcpServers` |
| Hermes | `~/.hermes/config.yaml` | `hermes config set mcp_servers...` |

配置内容：
```json
{
  "mcp-multi-note": {
    "command": "note",
    "args": ["mcp"]
  }
}
```

---

## 谁适合用

- **多笔记平台用户** — 飞书写文档、Obsidian 记日记、Notion 做项目管理……一个 Agent 全管
- **AI Agent 重度用户** — Claude Code / Cursor / Cline 用户，不想每个 Agent 配一遍笔记工具
- **笔记太多找不动的人** — `note search` 比手动翻快得多

---

## 开发

```bash
git clone https://github.com/Hermes-pm/mcp-multi-note.git
cd mcp-multi-note
pip install -e .
```

---

## License

MIT

---

> **v0.4 最新：** 搜索支持 `--from` / `--sort` / `--limit`，富内容（表格→Markdown、图片 URL 保留）。[查看更新日志](CHANGELOG.md)