AI导哈

笔记交互服务

NotesKeep MCP Server是一个通过Claude Code与笔记进行交互的服务，支持笔记的创建、更新、删除、归档和固定等操作。

  • by mariomosca
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 mariomosca/noteskeep-mcp

使用说明

注意保留MCP服务器

MCP（模型上下文协议）服务器 备注保存 -通过Claude Code与您的笔记进行交互。

安装

npm install -g noteskeep-mcp

或者直接与npx一起使用：

npx noteskeep-mcp

设置

1.获取API密钥

  1. 首选 备注保存
  2. 注册或登录
  3. 首选 设置 （标题中的齿轮图标）
  4. 点击 生成API密钥
  5. 复制生成的密钥

2.配置克劳德代码

选项A：使用CLI（推荐）

claude mcp add --transport stdio noteskeep --scope user \
  --env NOTESKEEP_API_KEY=your_api_key_here \
  -- npx noteskeep-mcp

选项B：手动配置

添加到您的 ~/.claude.json 在...之下 mcpServers 章节：

{
  "mcpServers": {
    "noteskeep": {
      "type": "stdio",
      "command": "npx",
      "args": ["noteskeep-mcp"],
      "env": {
        "NOTESKEEP_API_KEY": "your_api_key_here"
      }
    }
  }
}

3.重新启动克劳德代码

添加配置后，重新启动Claude Code以加载MCP服务器。

可用工具

工具 说明
list_notes 列出您的笔记（带可选限制和存档过滤器）
get_note 按ID获取特定注释
create_note 创建新注释（文本或清单）
update_note 更新笔记的内容、标题或颜色
delete_note 删除注释
archive_note 存档笔记
pin_note 固定或取消固定便条

环境变量

变量 必填 描述
NOTESKEEP_API_KEY 是 您的注释保留API密钥
NOTESKEEP_API_URL 否 自定义API URL（默认为https://noteskeep.vercel.app)

使用示例

配置后，您可以询问Claude：

  • “列出我的笔记”
  • 创建一个名为“购物清单”的便条，上面有牛奶、鸡蛋、面包等物品
  • “显示注释5”
  • “图钉注释3”
  • “存档注释7”
  • “用新内容更新笔记2：从今天开始的会议笔记”
  • “为我的周末任务创建一个清单注释”

注释类型

NotesWeek支持两种类型的笔记：

  • 文本注释：带有标题和内容的简单笔记
  • 检查表注释：带有可检查项目的注释

注释颜色

可用颜色： white, gray, yellow, orange, teal, blue, purple, pink

发展

# Clone the repository
git clone https://github.com/mariomosca/noteskeep-mcp.git
cd noteskeep-mcp

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

链接

许可证

麻省理工学院

相关 MCP