# geekmonks-mcp-bookmarks

Companion lab for the GeekMonks MCP series: a local **bookmarks** MCP server over **stdio** (TypeScript).

- Series hub: [MCP Without the Hype](https://blog.geekmonks.com/posts/ai-ml/mcp-without-the-hype/)
- Checkpoint tags: `part-3` (tools only), `part-4` (tools + resource `bookmarks://list` + prompt `summarize-bookmarks`)

**Host note:** tools show up most reliably in Cursor. Verify **resources** and **prompts** with MCP Inspector even when the host UI is limited.

## Requirements

- Node.js 20+

## Setup

```bash
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
```

Optional: set `BOOKMARKS_PATH` to a JSON file path. Default store: `./data/bookmarks.json` (created on first use; gitignored).

## MCP Inspector (prove tools without Cursor)

From the repo root after `npm run build`:

```bash
npx @modelcontextprotocol/inspector node dist/index.js
```

Connect, open **Tools**, try `list_bookmarks` / `add_bookmark` / `search_bookmarks`.

On tag `part-4`, also check **Resources** (`bookmarks://list`) and **Prompts** (`summarize-bookmarks`).

## Cursor (`mcp.json`)

Project config example (adjust the absolute path):

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

Reload MCP / start a new Agent chat. Approve tool calls when prompted.

## Logging rule

Never write protocol noise to **stdout**. This server logs only with `console.error` (stderr).

## License

MIT