mcpField
W
WhyNote

WhyNote

本地服务
github.com生产力011 周前更新
代码仓库访问官网

关于 WhyNote

WhyNote 是一个零依赖、只读的 MCP 服务，用于搜索和读取单个 WhyNote 账户中的笔记，也可列出待办并按日期读取笔记。

主要功能

  1. 01按不区分大小写的子串搜索笔记
  2. 02列出未完成或全部待办
  3. 03读取指定日期的完整笔记
  4. 04浏览锚定日期附近的已有笔记
  5. 05使用只读令牌访问

适用场景

  1. 01查找 WhyNote 笔记中的段落
  2. 02查看未完成的待办事项
  3. 03读取指定日期或附近日期的笔记

MCP 相关

WhyNote 将笔记搜索、待办列表和按日期读取笔记作为工具提供给 MCP 客户端。它使用只读令牌，不提供写入工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "coooolinz-why-note": {
      "command": "npx",
      "args": [
        "-y",
        "why-note-mcp"
      ],
      "env": {
        "NOTE_URL": "<NOTE_URL>",
        "NOTE_TOKEN": "<NOTE_TOKEN>"
      }
    }
  }
}
启动命令npx -y why-note-mcp
需要配置的环境变量
NOTE_URLBase URL of the WhyNote service
NOTE_TOKEN密钥Read-only token generated in WhyNote settings

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmwhy-note-mcp0.1.0

工具

4

收录的工具列表 · 更新于 3 周前

参数类型必填说明
qstring是要搜索的子字符串。
offsetinteger否

详细介绍

WhyNote MCP

一个零依赖、只读的 模型上下文协议 服务，用于搜索和读取一个 WhyNote 账户中的笔记。

安装

在 WhyNote 设置中生成一个只读令牌，然后将 MCP 客户端配置为运行 npx -y why-note-mcp，并设置 NOTE_URL 和 NOTE_TOKEN。

通用项目配置：

{
  "mcpServers": {
    "note": {
      "command": "npx",
      "args": ["-y", "why-note-mcp"],
      "env": {
        "NOTE_URL": "https://note.example.com",
        "NOTE_TOKEN": "<read-only-token>"
      }
    }
  }
}

Claude Code：

claude mcp add --scope user note \
  -e NOTE_URL=https://note.example.com \
  -e NOTE_TOKEN='<read-only-token>' \
  -- npx -y why-note-mcp

Codex CLI：

codex mcp add note \
  --env NOTE_URL=https://note.example.com \
  --env NOTE_TOKEN='<read-only-token>' \
  -- npx -y why-note-mcp

直接写入命令的值可能会保留在 shell 历史记录中。如果对此有顾虑，请改为编辑客户端配置。

需要 Node.js 18 或更高版本。

工具

  • search：按不区分大小写的子字符串搜索笔记行
  • todos：列出未完成或所有待办事项
  • read_day：读取某个日期的完整笔记和 etag
  • recent_days：读取锚点日期前后的现有笔记日期

安全性

服务仅读取环境中的 NOTE_URL 和 NOTE_TOKEN。它只会将令牌作为 Bearer 凭据发送到配置的 WhyNote URL。它绝不会接收账户密码，也不提供写入工具。

更改 WhyNote 账户密码会撤销其只读令牌。令牌过期或被撤销时，请在 WhyNote 设置中生成新令牌。

开发

npm ci
npm test
npm run pack:check

测试套件使用本地模拟 HTTP 服务；它不需要 WhyNote 账户、网络访问或第三方依赖。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。