mcp-apple-notes

让 Claude 直接读取你的 Apple 笔记,问答式检索个人知识库

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 搜索知识 🍴 复刻 56 🐛 待处理 21 👀 关注 7
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 419
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源项目,本地部署,免费使用。

项目预览

mcp-apple-notes 项目界面预览图
图片来源:项目官网

项目数据

分类搜索知识
开发团队RafalWilinski
定价模式🏷️完全免费
价格说明开源项目,本地部署,免费使用。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
主要语言TypeScript
技术栈/模型ai,claude,llm,mcp,model-context,rag
GitHub 星标★ 419
上线时间2024-12-16 00:00:00
代码更新2024-12-17
仓库体积2.3 MB
本站数据更新2026-11-08
维护状态低维护
收录时间2026-08-09
浏览次数3

项目介绍

mcp-apple-notes 是一个基于 Model Context Protocol (MCP) 的服务器,让 Claude 等 AI 助手能够直接读取和检索 Apple Notes 中的笔记内容。它解决了 Apple Notes 生态封闭、AI 工具无法直接访问本地笔记数据的问题。通过该工具,用户可以将个人笔记作为知识库,利用 RAG(检索增强生成)技术,让 AI 在对话中引用笔记内容进行回答。核心能力包括:通过 MCP 协议与 Claude 等客户端集成、对 Apple Notes 数据进行索引和语义搜索、支持自然语言查询笔记内容。项目使用 TypeScript 开发,目前处于早期阶段,但已获得 410 个星标,表明社区关注度较高。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 419

技术标签

使用教程

难度:入门 约 20 分钟 部署方式:本地安装 4 步

环境要求

  • macOS
  • Node.js 18+
  • 一个支持 MCP 的助手

安装与启动步骤

  1. 1拉仓库装依赖

    本地服务,跑在自己机器上。

    git clone https://github.com/RafalWilinski/mcp-apple-notes
  2. 2授权读取笔记

    它需要访问本机笔记数据。

  3. 3先建索引

    语义检索要先向量化,首次较慢。

  4. 4让助手查一条旧笔记

    用模糊描述去问,看召回是否准。

如何确认成功

用一段模糊描述能找回几个月前那条笔记,且返回结果附带原文片段而不是只给标题

注意事项

  • 它只支持苹果生态的笔记应用,其它平台用不了。
  • 笔记内容会进本地索引,索引文件本身要按敏感数据对待。
  • 新增笔记后要重新索引,否则检索不到。
  • 语义检索对同义表述友好,对精确编号类查询不如关键词。

核心亮点

  • 原生集成 Apple Notes,无需手动导出或同步,直接通过 MCP 协议访问本地笔记
  • 支持 RAG 检索,AI 能基于笔记内容进行上下文回答,提升个人知识管理效率
  • 基于 TypeScript 开发,类型安全,易于扩展和维护

不足之处

  • 仅支持 macOS 平台,且依赖 Apple Notes 的本地数据格式,跨平台不可用
  • 早期项目,文档和社区支持尚不完善,可能存在稳定性问题

适用场景

  • 个人知识管理:让 AI 助手基于自己的笔记内容回答日常问题
  • 写作辅助:在写作时快速检索历史笔记中的素材和灵感
  • 研究整理:对大量笔记进行语义搜索,快速定位相关信息

替代项目

obsidian-mcp、notion-mcp-server、evernote-mcp

上一篇:Agentic-AI-Systems

下一篇:Paper-Agent

同类项目推荐

awesome-ai-agents-2026 开源

一张清单,快速掌握2026年AI Agent全生态

A curated list of AI Agent frameworks, tools, platforms, and resources for 2026 — t···

★ 249 2026-08-09
cas 开源

让多个 Claude 代理协同干活,记忆任务规则全管好

Multi-agent orchestration for Claude Code. Persistent memory, tasks, rules, and skil···

★ 177 2026-08-09
agent 开源

用 Convex 快速搭带记忆的 AI 聊天智能体

Build AI agents on Convex with persistent chat history

★ 360 2026-10-01
Wake 开源

把散落的 AI 会话集中起来,搜一下就能接着聊

All your AI agent sessions in one place — browse, search, resume. Rust + GPUI.

★ 1547 2026-10-01
OrcaReplay 开源

给 AI Agent 装上录像机,出错可回放、可回退、可分支重跑

OrcaReplay — Time travel for AI agents. Record, replay, fork, and debug any agent r···

★ 401 2026-10-18
superset 开源

一个界面同时指挥多个 AI 编程代理,告别混乱切换

Paradev is an open-source Codex App and Conductor alternative. Orchestrate an army c···

★ 16087 2026-08-09
HuggingClaw 开源

免费云端部署 OpenClaw,告别 Mac Mini,零成本常在线。

No Mac Mini? No problem. HuggingClaw is the best free way to deploy OpenClaw on Hugg···

★ 56 2026-08-09
BotSharp-UI 开源

可视化搭建和管理 BotSharp AI 代理,省去写前端。

Build, test and manage your AI Agents in the central place.

★ 159 2026-08-09
agent-rules-books 开源

把经典编程书变成 AI 编码规则,提升代码质量

AGENTS.md rules / skills for AI coding agents: Codex, Cursor & Claude Code. Inspired···

★ 3221 2026-08-09