Servidor de marcadores MCP

Un servidor del Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de IA guardar y buscar marcadores utilizando las capacidades RAG de OpenAI. Almacena URLs con metadatos y realiza búsquedas inteligentes en toda tu colección de marcadores.

Características

Guardar marcadores: Almacena URLs con títulos y descripciones
Búsqueda inteligente: Busca en títulos y descripciones de marcadores utilizando búsqueda semántica
Impulsado por IA: Integración con OpenAI para una gestión y categorización inteligente de marcadores
Multiplataforma: Fácil integración en múltiples plataformas compatibles con MCP

Instalación

pip install mcp-bookmark-server

Configuración para hosts MCP

Claude Desktop

Añádelo a tu 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

Añádelo a tus ajustes de MCP en .cursor/mcp_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"
      }
    }
  }
}

Windsurf IDE

Añádelo a tu 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

Añádelo a tus ajustes de Zed bajo servidores MCP:

{
  "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 (Extensión de VS Code)

Añádelo a tu 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"
      }
    }
  ]
}

Herramientas disponibles

`save_bookmark`

Guarda un nuevo marcador.

Parámetros:

url (obligatorio): La URL a marcar
title (opcional): Título para el marcador
description (opcional): Descripción

Ejemplo:

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

`search_bookmarks`

Busca entre los marcadores guardados.

Parámetros:

query (obligatorio): Términos de búsqueda

Ejemplo:

{
  "query": "python tutorial"
}

Ejemplos de uso

Una vez configurado con tu host MCP, puedes usar lenguaje natural:

"Guarda este marcador: https://python.org con el título 'Python Official'"
"Busca en mis marcadores tutoriales de React"
"Encuentra marcadores sobre aprendizaje automático"
"Guarda https://github.com/microsoft/vscode como un marcador de herramienta de desarrollo"

Requisitos

Python 3.11+
Clave de API de OpenAI
Gestor de paquetes uvx instalado
Conexión a Internet para acceso al repositorio de GitHub

Variables de entorno

OPENAI_API_KEY: Requerida para la categorización y mejora de búsqueda impulsada por IA

Soporte

Problemas: GitHub Issues
Documentación de MCP: Model Context Protocol

Licencia

Licencia MIT

Creado para el ecosistema del Protocolo de Contexto de Modelo

mcp-bookmark-server