NotePlan MCP 服务器是一个消息控制协议(MCP)服务器,它使 Claude Desktop 能够与 NotePlan.co 进行交互。该服务器实现了 Claude 与 NotePlan 笔记的无缝集成,让你可以在 Claude 对话中直接查询、搜索、创建和更新笔记。
安装依赖:
npm install
构建项目:
npm run build
测试服务器:
npm start
你应该会看到:"NotePlan MCP server running on stdio"
配置 Claude Desktop(详见下面的详细设置)
git clone https://github.com/bscott/noteplan-mcp.git
cd noteplan-mcp
npm install
npm install -g noteplan-mcp
要在 Claude Desktop 中使用此 MCP 服务器,请将以下配置添加到你的 Claude Desktop 配置文件中:
~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json
~/.config/Claude/claude_desktop_config.json
将以下配置添加到你的 claude_desktop_config.json
文件中:
{
"mcpServers": {
"noteplan": {
"command": "node",
"args": ["/absolute/path/to/noteplan-mcp/build/index.js"],
"cwd": "/absolute/path/to/noteplan-mcp"
}
}
}
重要提示:请将 /absolute/path/to/noteplan-mcp
替换为你克隆此仓库的实际路径。
保存配置后,完全重启 Claude Desktop 以使更改生效。
配置完成后,你可以在 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 |
设置完成后,你可以向 Claude 提出以下问题:
Claude 将自动使用相应的 NotePlan MCP 工具来完成这些请求。
npm run dev
此命令将构建 TypeScript 代码,并使用 nodemon 在文件更改时自动重启服务器。
npm run build
将 TypeScript 代码编译为 JavaScript 并输出到 build/
目录。
npm test
npm run lint
noteplan-mcp/
├── src/
│ ├── index.ts # 主 MCP 服务器实现
│ ├── index.js # HTTP 服务器(可选)
│ └── services/
│ └── noteService.ts # 笔记管理逻辑
├── build/ # 编译后的 JavaScript 输出
│ ├── index.js # 编译后的 MCP 服务器
│ └── services/
│ └── noteService.js # 编译后的笔记服务
├── tests/
│ └── index.test.js # 测试文件
├── tsconfig.json # TypeScript 配置
├── package.json
└── README.md
claude_desktop_config.json
中的路径是绝对路径且正确。~/Library/Logs/Claude/mcp-server-noteplan.log
%LOCALAPPDATA%\Claude\Logs\mcp-server-noteplan.log
npm start
启动服务器。手动测试服务器:
cd /path/to/noteplan-mcp
npm run build
npm start
使用 MCP 检查器进行调试:
npm run inspector
检查 Claude Desktop 日志中的连接状态。
在 Claude 中尝试一个简单的命令:"Can you show me my notes?"(你能显示我的笔记吗?)
默认情况下,服务器在标准位置查找 NotePlan 文件。如果你使用自定义目录,可以修改 noteService.js
文件以指向你的 NotePlan 数据目录。
目前不需要环境变量,但未来版本可能支持:
NOTEPLAN_DATA_DIR
:自定义 NotePlan 数据目录MCP_LOG_LEVEL
:日志详细程度git checkout -b my-new-feature
npm test
npm run lint
git commit -am 'Add some feature'
git push origin my-new-feature
本项目采用 MIT 许可证,详情请参阅 LICENSE 文件。