geekmonks-mcp-bookmarks

GeekMonks MCP 系列文章的配套实验项目：一个基于 stdio（TypeScript）的本地 书签 MCP 服务器。

• 系列文章入口：MCP 没那么玄乎

• 检查点标签：part-3（仅工具）、part-4（工具 + 资源 bookmarks://list + 提示词 summarize-bookmarks）

主机说明： 工具在 Cursor 中显示最稳定。即使主机界面有限，也请使用 MCP Inspector 验证 资源 和 提示词。

环境要求

• Node.js 20+

Related MCP server: raindrop-mcp

安装

git clone https://github.com/SRVivek1/geekmonks-mcp-bookmarks.git
cd geekmonks-mcp-bookmarks
git checkout part-3   # or part-4
npm install
npm run build

可选：设置 BOOKMARKS_PATH 指向一个 JSON 文件路径。默认存储位置：./data/bookmarks.json（首次使用时创建；已加入 .gitignore）。

使用 MCP Inspector 验证（无需 Cursor）

在 npm run build 之后，从仓库根目录执行：

npx @modelcontextprotocol/inspector node dist/index.js

连接后，打开 工具，尝试 list_bookmarks / add_bookmark / search_bookmarks。

在 part-4 标签下，还可以查看 资源（bookmarks://list）和 提示词（summarize-bookmarks）。

在 Cursor 中配置（mcp.json）

项目配置示例（请调整绝对路径）：

{
  "mcpServers": {
    "bookmarks": {
      "type": "stdio",
      "command": "node",
      "args": ["/ABS/PATH/TO/geekmonks-mcp-bookmarks/dist/index.js"]
    }
  }
}

重新加载 MCP / 开启新的 Agent 对话。在提示时批准工具调用。

日志规则

切勿向 stdout 写入协议噪声。本服务器仅通过 console.error（stderr）记录日志。

许可证

MIT