MCP 북마크 서버

AI 어시스턴트가 OpenAI의 RAG 기능을 사용하여 북마크를 저장하고 검색할 수 있도록 지원하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 메타데이터와 함께 URL을 저장하고 북마크 컬렉션 전체에서 지능적인 검색을 수행하세요.

기능

북마크 저장: 제목 및 설명과 함께 URL 저장
스마트 검색: 의미론적 검색을 사용하여 북마크 제목 및 설명 전체 검색
AI 기반: 지능적인 북마크 관리 및 분류를 위한 OpenAI 통합
멀티 플랫폼: 여러 MCP 호환 플랫폼에서 쉽게 통합

설치

pip install mcp-bookmark-server

MCP 호스트 설정

Claude Desktop

claude_desktop_config.json에 추가하세요:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "bookmark": {
      "command": "/usr/local/bin/uvx",
      "args": [
        "--from",
        "git+https://github.com/preedew17/mcp-bookmark.git",
        "mcp-bookmark-server"
      ],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

Cursor IDE

.cursor/mcp_config.json의 MCP 설정에 추가하세요:

{
  "mcpServers": {
    "bookmark": {
      "command": "/usr/local/bin/uvx",
      "args": [
        "--from",
        "git+https://github.com/preedew17/mcp-bookmark.git",
        "mcp-bookmark-server"
      ],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

Windsurf IDE

windsurf_config.json에 추가하세요:

{
  "mcpServers": {
    "bookmark": {
      "command": "/usr/local/bin/uvx",
      "args": [
        "--from",
        "git+https://github.com/preedew17/mcp-bookmark.git",
        "mcp-bookmark-server"
      ],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

Zed Editor

MCP 서버 아래의 Zed 설정에 추가하세요:

{
  "mcp": {
    "servers": {
      "bookmark": {
        "command": "/usr/local/bin/uvx",
        "args": [
          "--from",
          "git+https://github.com/preedew17/mcp-bookmark.git",
          "mcp-bookmark-server"
        ],
        "env": {
          "OPENAI_API_KEY": "your-openai-api-key-here"
        }
      }
    }
  }
}

Continue (VS Code 확장 프로그램)

continue/config.json에 추가하세요:

{
  "mcpServers": [
    {
      "name": "bookmark",
      "command": "/usr/local/bin/uvx",
      "args": [
        "--from",
        "git+https://github.com/preedew17/mcp-bookmark.git",
        "mcp-bookmark-server"
      ],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  ]
}

사용 가능한 도구

`save_bookmark`

새 북마크를 저장합니다.

매개변수:

url (필수): 북마크할 URL
title (선택): 북마크 제목
description (선택): 설명

예시:

{
  "url": "https://example.com",
  "title": "Example Site",
  "description": "A useful example website"
}

`search_bookmarks`

저장된 북마크를 검색합니다.

매개변수:

query (필수): 검색어

예시:

{
  "query": "python tutorial"
}

사용 예시

MCP 호스트와 설정이 완료되면 자연어를 사용할 수 있습니다:

"이 북마크 저장: https://python.org, 제목 'Python Official'"
"내 북마크에서 React 튜토리얼 검색해줘"
"머신러닝 관련 북마크 찾아줘"
"https://github.com/microsoft/vscode 를 개발 도구 북마크로 저장해줘"

요구 사항

Python 3.11+
OpenAI API 키
uvx 패키지 관리자 설치됨
GitHub 저장소 액세스를 위한 인터넷 연결

환경 변수

OPENAI_API_KEY: AI 기반 분류 및 검색 향상을 위해 필수

지원

이슈: GitHub Issues
MCP 문서: Model Context Protocol

라이선스

MIT 라이선스

모델 컨텍스트 프로토콜 생태계를 위해 구축됨

mcp-bookmark-server