Lapis MCP server
2026년 11월 3일 커밋AI 클라이언트가 로컬 우선 Markdown 노트 라이브러리를 읽고, 검색하고, 생성하고, 내용을 추가하거나 업데이트할 수 있도록 합니다.
다른 이름 zexadev/lapisnote
- 스타
- 16
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 3일
- 라이선스
- AGPL-3.0
Lapis MCP란?
AI 클라이언트가 로컬 우선 Markdown 노트 라이브러리를 읽고, 검색하고, 생성하고, 내용을 추가하거나 업데이트할 수 있도록 합니다.
프로젝트 README에서 생성된 요약
Lapis MCP server 정보
Lapis는 개발자와 작가가 AI 에이전트를 통해 개인 지식 베이스를 관리할 수 있게 해줍니다. 이 로컬 우선 Markdown 노트 애플리케이션은 통합된 MCP server를 제공하여 Claude Code, Cursor, Windsurf와 같은 도구가 로컬 SQLite 데이터베이스와 직접 상호작용할 수 있도록 합니다. AI 어시스턴트는 단순히 파일을 읽는 것에 그치지 않고, 노트를 생성, 추가 또는 업데이트함으로써 라이브러리를 능동적으로 관리할 수 있습니다.
사용자는 Windows, Android 또는 iOS에 배포하여 동기화된 Markdown 라이브러리를 유지할 수 있습니다. 이 시스템은 중앙 서버 없이 기기 간 교차 네트워크 동기화를 위해 암호화된 P2P 기술을 사용합니다. MCP server가 127.0.0.1:19230에서 로컬로 실행되므로 데이터에 대한 제어권을 유지하면서 get_note, search_notes, list_notes, create_note, append_note, update_note라는 6가지 특정 도구를 사용할 수 있습니다. 이러한 구성은 정적인 노트 작성과 능동적인 AI 기반 문서 관리 사이의 간극을 메워줍니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능zexadev/lapisnote is public and reachablegithub.com/zexadev/lapisnote ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-03github.com/zexadev/lapisnote ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기📖 简介
Lapis(GitHub 仓库 lapisnote,前身 JDNotes)是一款本地优先的笔记应用(Tauri 2 构建),桌面与手机同一套功能。支持局域网 + 跨网 P2P 加密多设备同步,AI 可经 MCP 直接读写你的笔记库。数据本地存储,隐私安全。
Lapis (repository
lapisnote, formerly JDNotes) — local-first notes for Windows / Android / iOS with a Markdown editor, a built-in AI assistant, encrypted P2P sync and an MCP server for Claude Code / Cursor. Official repository: github.com/zexadev/lapisnote; forks are not maintained by this project.
前身是 jdnotes(JD Notes):自 2.0 起更名为 Lapis。同一应用、同一套数据,老版本直接安装新版即可升级,笔记原样保留。
| 特性 | 说明 | |
|---|---|---|
| 📱 | 三端同一套功能 | Windows、Android、iOS 都是完整版:编辑器、AI、日历、提醒、同步一个不少,手机页面自适应 |
| 🔄 | 多设备同步 | 局域网自动发现 + 跨网 P2P 加密直连,电脑与手机互通,免费、无中心服务器 |
| 🔌 | AI Agent 读写 | 内置 MCP Server,Claude Code / Cursor 等 AI 工具可直接在你的本地笔记库查看、创建、追加、修改笔记 |
| 🔗 | 双向链接 | 输入 [[ 引用其它笔记(或正文直接写 [[标题]]),单击跳转 + 自动反向链接 |
| 🤖 | AI 赋能 | 多平台 AI 助手,支持 DeepSeek / Claude / Gemini / Ollama |
| 🔒 | 本地优先 | 本地 SQLite 存储,断网可用,数据完全掌控在您手中 |
| ⚡ | 轻量高效 | 基于 Rust + Web 技术,安装包约 8MB,启动快速 |
✨ 功能特性
📝 富文本编辑
- Markdown 支持 — 原生支持 Markdown 语法,所见即所得
- 固定工具栏 — 文本格式、列表、引用、代码块、插入图片等常用操作
- 代码高亮 — 支持 20+ 种编程语言语法高亮
- 图片管理 — 工具栏插入、粘贴、拖拽插入,可缩放和预览大图
- 待办列表 — 支持
- [ ]/- [x]Markdown 语法,工具栏和斜杠命令快速创建 - 斜杠命令 — 输入
/快速插入各种内容块和 AI 命令 - 代码粘贴即代码块 — 从 VS Code 等编辑器粘贴代码自动生成带语言高亮的代码块,含 ``` 围栏的纯文本同样识别
- 链接交互 — Ctrl+Click 打开外部链接(类似 VS Code);悬停链接弹出操作卡,可打开、复制、编辑、取消链接
- 笔记引用 / 双向链接 — 输入
[[选择引用,或正文直接写[[标题]]文本(含 AI 经 MCP 写入的)都会渲染成可点引用、单击按标题跳转;被引用笔记底部自动显示反向链接(基于稳定 ID,跨设备同步有效) - 自动保存 — 实时保存,永不丢失
🔄 多设备同步
- mDNS 自动发现 — 同一 WiFi 下自动发现其它打开 Lapis 的设备,无需手输 IP
- 笔记多选同步 — 点设备旁「选笔记」弹模态框,搜索/全选/单选要给对方的笔记,发什么自己说了算
- 跨网 P2P 直连 — 公司↔家不同网络也能加密直连(基于 iroh,NAT 打洞 + relay 兜底)
- 编辑器旁单条同步 — 编辑器头部「推送」按钮把当前笔记直接发给某设备
- 冲突保留双份 — 改同一处自动生成「冲突副本」笔记,绝不静默丢数据
- 首次配对码 — 新设备首次同步时双方各自显示 6 位数字,核对一致才放行,防中间人
- 私有笔记 — 标记为私有的笔记不参与任何同步,只留在本机
- 同步包文件 — 导出/导入同步包,无网络也能经 U 盘搬运笔记
- 设备在线状态 — 跨网设备列表实时显示在线/离线
- 持久设备指纹 — 重启同一台机器在对方眼里仍是同一设备
- 首次启动提示 — Windows 防火墙弹窗时勾选「专用网络」让 mDNS 通过
🤖 AI 智能助手
- 多平台支持 — DeepSeek、OpenAI、Anthropic Claude、Google Gemini、Ollama
- 多来源管理 — 同时配置多个 AI 来源,侧边栏快速切换
- 内联改写 — 选中文本
Ctrl+J下指令,AI 就地改写:原文红色删除线保留、新文本流式生成,Tab 接受、Esc 放弃,可重试或追加指令 - 侧边栏对话 — 多对话管理(
Ctrl+L),自动命名、随时切换;支持粘贴/拖拽图片提问 - AI 读写笔记 — 对话中 AI 可直接查询、创建、追加你的笔记
- 上下文压缩 — 长对话自动压缩为摘要继续聊,输入卡实时显示上下文占用
- AI 功能菜单 — 续写、改写、总结、翻译、问答
- 自动标题 — AI 自动生成笔记标题和标签
🔗 MCP Server 集成
让 AI agent 不只是「读」你的笔记,而是直接「写」进你的本地笔记库 —— 这是 Lapis 区别于多数本地笔记工具的地方。
- 内置 HTTP MCP Server — Lapis 启动时自动提供服务(
127.0.0.1:19230) - 自动注册 — 启动时自动注册到 Claude Code、Cursor、Windsurf 等 9 个 AI 工具
- 6 个工具 — 读取(
get_note、search_notes、list_notes)+ 写入(create_note、append_note、update_note) - Agent Skill 自动安装 — 启动时自动安装 Agent Skill 到 Claude Code、Copilot、Gemini CLI,AI 工具自动获知使用方法
- AI 编程工具集成 — 在 Claude Code 中直接说"查看笔记"或"把这段代码保存到笔记"
📊 数据概览
- 处处可点的入口面板 — 笔记总数、收藏直达对应视图,点标签进标签视图,点热力图格子直达日历当天
- 写作热力图 — 近 14 周按星期对齐(列为周、行为星期几),颜色越深当天笔记越多
- 待办提醒 — 即将到期的提醒按时间排列、过期标红,点击直达笔记
- 新增趋势 — 7 天 / 30 天切换,悬停查看每日数量
- 24h 时段分布 — 找出你的高产时段
- Top 5 标签 — 最常用标签的使用频次,配色与侧栏、编辑器一致
- 最近笔记 — 一键点击直接打开对应笔记
- 连续天数 — 当天还没写不断签
- 跟随应用主题 — 浅色/深色自动切换
📅 日历
- 月网格 — 每格直接显示当天笔记与提醒,标签自动配色,一眼看到哪天有什么
- 日面板 — 点选任意日期,右侧即时展示当天笔记与提醒,单击直达
- 任意日期记笔记 — 双击格子(或按 Enter)就在那一天新建笔记
- 拖拽改期 — 拖动笔记调整归属日期,拖动提醒改约定时间
- 键盘导航 — 方向键移动日期,PgUp/PgDn 翻月,T 回到今天
- 导出本月 — 当月笔记一键导出为 Markdown / JSON
🗂️ 笔记管理
- 智能搜索 — 全局搜索,快速定位(
Ctrl+K) - 收藏功能 — 重要笔记一键收藏
- 废纸篓 — 误删笔记可恢复
- 标签系统 — 灵活分类管理,标签自动配色、处处一致
- 提醒功能 — 为笔记设置定时提醒
📤 导出分享
- PDF 导出 — 通过浏览器打印功能导出 PDF
- Markdown — 导出为 Markdown 文件
🎨 个性化
- 主题切换 — 深色/浅色主题,日夜动画开关
- 自动更新 — 启动时自动检查新版本,发现更新主动弹窗提示
- 更新日志 — 应用内直接查看各版本更新内容
📥 下载安装
Windows
从 Releases 下载最新版本:
| 文件 | 说明 |
|---|---|
Lapis_x.x.x_x64-setup.exe |
Windows 安装包(推荐) |
Lapis_x.x.x_x64_en-US.msi |
Windows MSI 安装包 |
系统要求: Windows 10/11 (64位)
Android
| 文件 | 说明 |
|---|---|
Lapis_x.x.x_aarch64.apk |
Android 安装包,需 7.0 以上的 arm64 设备 |
打开安装包按提示安装。之后新版本在应用内检查更新、覆盖安装,笔记保留。
iOS(自签)
| 文件 | 说明 |
|---|---|
Lapis_x.x.x_ios_unsigned.ipa |
未签名 IPA,用 AltStore / Sideloadly 签名安装 |
不在 App Store。免费 Apple ID 签出的应用 7 天过期,需按工具提示续签。iOS 版尚未经真机验收。
手机与电脑的配对同步、更新方式见手机端文档。
🚀 快速开始
安装步骤
- 从 Releases 下载最新安装包
- 运行安装程序,按提示完成安装
- 启动 Lapis,开始您的笔记之旅
配置 AI 功能
- 打开设置(点击左下角齿轮图标)
- 在「AI 设置」中添加 AI 来源
- 支持 DeepSeek、OpenAI、Anthropic、Google、Ollama 等多个平台
使用 MCP Server
Lapis 启动时自动在 127.0.0.1:19230 提供 MCP Server,并自动注册到 Claude Code。在 Claude Code 中可以直接说"把这段内容保存到笔记"。
手动注册:
claude mcp add --transport http lapis http://127.0.0.1:19230/mcp
快捷键
| 快捷键 | 功能 |
|---|---|
Ctrl+K |
全局搜索 |
Ctrl+L |
打开/关闭 AI 侧栏 |
Ctrl+J |
内联提问(选中文本后) |
Ctrl+\ |
循环切换侧栏(展开/收起/隐藏) |
F11 |
沉浸模式(全屏专注写作) |
Ctrl+B |
粗体 |
Ctrl+I |
斜体 |
Ctrl+Shift+C |
代码块 |
Ctrl+Click |
打开链接 |
/ |
斜杠命令菜单 |
🔧 技术架构
💬 反馈支持
如果您在使用中遇到问题或有功能建议:
- 📧 提交 GitHub Issue
- 📖 查看 文档站
常见问题
📄 许可协议
Lapis 2.0 及以后版本采用 GNU AGPL-3.0-or-later(强 copyleft:修改 / 分发、乃至通过网络提供服务,都须以 AGPL 开源其改动)。
附加条款(AGPL §7,见 NOTICE):修改或分发时,需在你的仓库 README / 源码 / NOTICE 中保留对原作者与本项目的署名(Based on Lapis — © 2026 zexadev — https://github.com/zexadev/lapisnote)并标注你的改动。不要求展示在 app 界面里。
历史版本 1.9.1 及以前以 MIT License 发布,仍按 MIT 提供。
Copyright © 2026 Zexa (zexadev)
🙏 致谢
感谢以下开源项目为 Lapis 提供技术支持:
Lapis MCP 질문
Lapis MCP server를 어떻게 사용하나요?
Lapis를 실행하면 127.0.0.1:19230에서 자동으로 MCP를 제공하며 Claude Code에 스스로를 등록합니다. 또한 claude mcp add 명령어를 사용하여 수동으로 등록할 수도 있습니다.
Lapis MCP server는 어떤 도구를 제공하나요?
노트 읽기용 도구 3개(get_note, search_notes, list_notes)와 쓰기용 도구 3개(create_note, append_note, update_note)를 포함하여 총 6개의 도구를 제공합니다.
Lapis는 노트를 어디에 저장하나요?
모든 데이터는 %APPDATA%/com.jdnotes.app/ 경로의 로컬 SQLite 데이터베이스에 저장되며, 설정에서 저장 위치를 변경할 수 있습니다.
Lapis가 자동으로 등록되는 AI 코딩 도구는 무엇인가요?
시작 시 Claude Code, Cursor, Windsurf 및 other AI 도구에 등록되며, Claude Code, Copilot, Gemini CLI에 Agent Skill을 설치합니다.