AI导哈

NotePlan MCP 服务

NotePlan MCP 服务是一个消息控制协议（MCP）服务器，用于实现 Claude Desktop 与 NotePlan.co 的无缝交互。该服务允许用户直接从 Claude 对话中查询、搜索、创建和更新 NotePlan 笔记，提供了高效的笔记管理功能。

  • by bscott
  • 1 星标
  • 更新于
在 GitHub 查看 bscott/noteplan-mcp

使用说明

基本能力

产品定位

NotePlan MCP 服务是一个连接 Claude Desktop 和 NotePlan 的中间件，旨在通过 Claude 对话直接管理和操作 NotePlan 笔记。

核心功能

  • 读取笔记：获取所有笔记、按 ID 获取特定笔记或从特定文件夹获取笔记
  • 搜索功能：在所有笔记中进行全文搜索
  • 创建笔记：创建带有标题、内容和文件夹组织的新笔记
  • 每日笔记：创建和管理带有自动日期格式的每日笔记
  • 更新笔记：修改现有笔记的标题和内容
  • 文件夹组织：按文件夹组织和筛选笔记

适用场景

  • 通过 Claude 对话快速访问和管理 NotePlan 笔记
  • 在 Claude 中直接创建和更新笔记
  • 搜索和组织大量笔记内容

工具列表

工具 描述 参数
get_notes 从 NotePlan 获取所有笔记 无
get_note_by_id 按 ID 获取特定笔记 id（必需）
search_notes 按查询搜索笔记 query（必需）
get_notes_by_folder 从文件夹获取笔记 folder（必需）
create_note 创建新笔记 title（必需），content，folder
create_daily_note 创建每日笔记 date（YYYY-MM-DD），content
update_note 更新现有笔记 id（必需），title，content

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm

安装教程

选项1：从 GitHub 克隆

git clone https://github.com/bscott/noteplan-mcp.git
cd noteplan-mcp
npm install

选项2：作为 NPM 包安装（即将推出）

npm install -g noteplan-mcp

快速开始

  1. 安装依赖：

    npm install

  2. 构建项目：

    npm run build

  3. 测试服务器：

    npm start

    您应该看到："NotePlan MCP server running on stdio"

  4. 配置 Claude Desktop（见下方详细设置）

Claude Desktop 配置

  1. 找到您的配置文件：

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json

  2. 添加 NotePlan MCP 服务器配置：

    {
  "mcpServers": {
    "noteplan": {
      "command": "node",
      "args": ["/absolute/path/to/noteplan-mcp/build/index.js"],
      "cwd": "/absolute/path/to/noteplan-mcp"
    }
  }
}

    注意：将 /absolute/path/to/noteplan-mcp 替换为实际路径

  3. 完全重启 Claude Desktop

调试方式

  1. 手动测试服务器：

    cd /path/to/noteplan-mcp
npm run build
npm start

  2. 使用 MCP 检查器进行调试：

    npm run inspector

  3. 检查 Claude Desktop 日志中的连接状态

  4. 在 Claude 中尝试简单命令："你能显示我的笔记吗？"

相关 MCP