使用说明
笔记本电脑MCP服务器
🚀 为您的AI助手解锁持久内存！ 将任何LLM或类似Copilot的工具变成一个深思熟虑的伴侣，在对话中记住。这个轻量级的MCP服务器为您的AI客户端提供了本地私人笔记本电脑的超能力——可以把它想象成一个永远不会忘记的数字大脑。
为什么选择笔记本MCP服务器？
- 🔒 本地和私人 --所有内容都以纯JSON文件的形式保存在您的机器上。没有云，没有账户，没有数据挖掘。
- 🌐 通用兼容性 --与任何兼容MCP的客户端（LLM、IDE助手、AI代理）无缝协作。
- ⚡ 迅速的 --针对本地存储上的即时读写进行了优化。
- 🛡️ 零遥测 --你的数据就是你的，句号。
- 🎯 项目隔离 --智能设计可防止不同项目相互干扰，同时在需要时实现安全的笔记本电脑共享。
核心功能
- 命名笔记本 --在逻辑上分开的笔记本中组织信息
- 基于页面的存储 --每个笔记本包含多页文本内容
- JSON持久化 --每个笔记本电脑一个干净的JSON文件，便于备份和移植
- 隔离访问 --无“列出所有笔记本”功能，确保项目隐私
- 安全共享 --根据需要按名称在项目之间共享特定笔记本
- 最小API表面 --干净、专注的工具集，没有不必要的复杂性
快速开始
- 下载 最新二进制文件来自 发布.
- 注册 您的MCP兼容客户端中的此服务器（通过stdio）。 有关如何添加MCP服务器，请参阅客户的文档。
- 开始使用 您的AI客户端提供的以下工具。
默认存储目录：
./notebooks
自定义位置： 设置环境变量NOTEBOOK_STORAGE_DIRECTORY=/path/to/notebooks
可用工具（MCP API）
📚 笔记本管理
create_notebook--创建新笔记本或更新其描述- 参数：
notebookName（字符串），description（字符串） - 返回：确认消息
- 参数：
📄 页面操作
-
get_notebook_page_names--获取笔记本描述和页面名称列表（无内容）- 参数：
notebookName（字符串） - 退货：
NotebookSummary带有描述和页面名称 - 🔒 注意：这是发现页面的唯一方法——出于隐私考虑，没有全球笔记本列表
- 参数：
-
get_page_text--阅读特定页面的全文内容- 参数：
notebookName（字符串），page（字符串） - 返回：页面文本内容（如果页面不存在，则为空字符串）
- 参数：
-
upsert_page--创建新页面或更新现有页面内容- 参数：
notebookName（字符串），page（字符串），text（字符串） - 返回：确认消息
- 💡 如果笔记本不存在，则自动创建笔记本
- 参数：
-
remove_page--从笔记本中删除页面- 参数：
notebookName（字符串），page（字符串） - 退货：
true如果页面被删除，false如果页面不存在
- 参数：
🛡️ 隐私设计
重要提示： 有故意 不 “列出所有笔记本”功能。这确保了不同的项目不会干扰彼此的数据。但是，如果您知道笔记本名称，则可以在项目之间安全地共享它。
数据存储格式
每个笔记本都存储在存储目录中的单个JSON文件中。该结构简单易懂：
{
"description": "My project notes",
"pages": {
"page-name-1": "Content of first page...",
"page-name-2": "Content of second page...",
"meeting-notes": "Notes from today's meeting..."
}
}
页面名称用作键，页面文本存储为值。此格式使备份、版本控制或在需要时手动编辑笔记本变得容易。
兼容性和集成
适用于任何 MCP客户端 支持stdio工具执行，包括：
- 克劳德桌面
- VS代码副本扩展
- 定制LLM代理
- IDE助手
- AI工作流工具
与Copilot风格的助手一起，它是一个轻量级的本地存储系统。
贡献
欢迎问题和拉取请求！请随意：
- 报告错误或建议功能
- 改进文档
- 提交代码改进
- 分享使用示例
许可证--0BSD
版权所有（c）2025 DimonSmart
特此授予出于任何目的使用、复制、修改和/或分发本软件的许可，无论是否收费。
软件按“原样”提供，作者不承担与此软件有关的所有保证，包括对适销性和适用性的所有暗示保证。在任何情况下，作者均不对任何特殊、直接、间接或后果性损害，或因使用或执行本软件而导致的使用、数据或利润损失而造成的任何损害负责，无论是在合同诉讼、疏忽还是其他侵权诉讼中。
