geekmonks-mcp-bookmarks

GeekMonks MCP 시리즈의 동반 실습: stdio(TypeScript) 기반 로컬 bookmarks MCP 서버.

• 시리즈 허브: MCP Without the Hype

• 체크포인트 태그: part-3 (도구만), part-4 (도구 + 리소스 bookmarks://list + 프롬프트 summarize-bookmarks)

호스트 참고: 도구는 Cursor에서 가장 확실하게 표시됩니다. 호스트 UI가 제한적이더라도 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