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

Related MCP server: bookmark-lens

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