note-tool

✨ v0.4 新亮点：搜索优化 + 富内容支持

note search 支持 --from <平台> 过滤、--sort date 按时间排序、--limit N 限制数量。 OneNote 和 Notion 的表格现在自动转为 Markdown，图片 URL 完整保留。

note-tool 是一个多平台笔记 MCP Server，已发布到 PyPI。装一个包，把飞书、OneNote、Obsidian、语雀、Notion、印象笔记整合到一个标准 MCP 入口。你的 AI Agent（Claude Code、Cursor、Cline、Hermes……）就能直接在对话中查你的笔记。

快速开始

# 1. 安装
pip install note-tool

# 2. 运行安装向导
note setup

# 3. 配置到你的 AI Agent（详见各 Agent 的 MCP 配置文档）
# Claude Code / Cursor / Cline:
# {
#   "note-tool": {
#     "command": "note",
#     "args": ["mcp"]
#   }
# }

支持的平台

未配置的平台不会出现在 Agent 的工具列表中。 运行时配置任意组合，互不干扰。

架构

AI Agent (Claude Code / Cursor / Cline / Hermes / ...)
    │
    ▼  MCP stdio 协议 (JSON-RPC)
┌──────────────────────┐
│   note mcp           │  ← MCP Server，标准协议
│   tools/list         │
│   tools/call         │
└──────┬───────────────┘
       │
┌──────▼────┐ ┌──────▼──────┐ ┌──────▼──────┐
│ Obsidian  │ │ 飞书        │ │ OneNote     │  ← 每个平台独立 adapter
│ (本地文件)  │ │ (Feishu)    │ │ (Microsoft  │
│           │ │             │ │  Graph)     │
└───────────┘ └─────────────┘ └─────────────┘
                   ...

设计原则：

• MCP 优先 — 主入口是 MCP Server，所有 Agent 统一接入
• 可插拔 — 每个平台一个 adapter，互不影响
• 零噪音 — 只暴露已配置平台的 tool，未配的自动隐藏
• CLI 副产品 — Agent 不直接调的，终端用户也能用 note <platform> <command>

用法

# 安装向导（推荐）
note setup

# 跨平台搜索（新）
note search 关键词                    # 搜所有平台
note search 关键词 --from obsidian   # 仅 Obsidian
note search API --from feishu,notion --sort -date --limit 10

# 平台 CLI
note feishu search "关键词"
note onenote search "keyword"
note obsidian search "关键词"
note yuque search "关键词"
note notion search "keyword"
note evernote search "keyword"

# MCP Server（给 Agent 用）
note mcp

MCP 配置

将以下配置添加到你的 AI Agent 的 MCP 配置文件中：

{
  "note-tool": {
    "command": "note",
    "args": ["mcp"]
  }
}

支持的 Agent：

• Claude Code — ~/.claude/settings.json 或项目级 CLAUDE.md
• Cursor — ~/.cursor/mcp.json
• Cline — ~/.cline/mcp_settings.json
• Hermes — ~/.hermes/config.yaml 中配置 MCP tool

Tool 列表

每个已配置的平台会暴露以下 tool（前缀为平台名）：

各平台具体实现略有差异，详见平台指南。

开发

git clone https://github.com/your-username/note-tool.git
cd note-tool
pip install -e .

项目状态

note-tool 处于早期开发阶段。当前已覆盖 6 个平台，代码就绪，部分平台需用户自行获取 API 凭证。

License

MIT