{
  "markdown": "# MCP Bookmark Server\n\n<!-- mcp-name: io.github.preedew17/mcp-bookmark -->\n\nA Model Context Protocol (MCP) server that enables AI assistants to save and search bookmarks using OpenAI's RAG capabilities. Store URLs with metadata and perform intelligent searches across your bookmark collection.\n\n## Features\n\n- **Save Bookmarks**: Store URLs with titles and descriptions\n- **Smart Search**: Search across bookmark titles and descriptions using semantic search\n- **AI-Powered**: Integration with OpenAI for intelligent bookmark management and categorization\n- **Multi-Platform**: Easy integration across multiple MCP-compatible platforms\n\n## Installation\n\n```bash\npip install mcp-bookmark-server\n```\n\n## Configuration for MCP Hosts\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"bookmark\": {\n      \"command\": \"/usr/local/bin/uvx\",\n      \"args\": [\n        \"--from\",\n        \"git+https://github.com/preedew17/mcp-bookmark.git\",\n        \"mcp-bookmark-server\"\n      ],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-openai-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor IDE\n\nAdd to your MCP settings in `.cursor/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"bookmark\": {\n      \"command\": \"/usr/local/bin/uvx\",\n      \"args\": [\n        \"--from\",\n        \"git+https://github.com/preedew17/mcp-bookmark.git\",\n        \"mcp-bookmark-server\"\n      ],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-openai-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf IDE\n\nAdd to your `windsurf_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"bookmark\": {\n      \"command\": \"/usr/local/bin/uvx\",\n      \"args\": [\n        \"--from\",\n        \"git+https://github.com/preedew17/mcp-bookmark.git\",\n        \"mcp-bookmark-server\"\n      ],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-openai-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Zed Editor\n\nAdd to your Zed settings under MCP servers:\n\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"bookmark\": {\n        \"command\": \"/usr/local/bin/uvx\",\n        \"args\": [\n          \"--from\",\n          \"git+https://github.com/preedew17/mcp-bookmark.git\",\n          \"mcp-bookmark-server\"\n        ],\n        \"env\": {\n          \"OPENAI_API_KEY\": \"your-openai-api-key-here\"\n        }\n      }\n    }\n  }\n}\n```\n\n### Continue (VS Code Extension)\n\nAdd to your `continue/config.json`:\n\n```json\n{\n  \"mcpServers\": [\n    {\n      \"name\": \"bookmark\",\n      \"command\": \"/usr/local/bin/uvx\",\n      \"args\": [\n        \"--from\",\n        \"git+https://github.com/preedew17/mcp-bookmark.git\",\n        \"mcp-bookmark-server\"\n      ],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-openai-api-key-here\"\n      }\n    }\n  ]\n}\n```\n\n## Available Tools\n\n### `save_bookmark`\nSave a new bookmark.\n\n**Parameters:**\n- `url` (required): The URL to bookmark\n- `title` (optional): Title for the bookmark\n- `description` (optional): Description\n\n**Example:**\n```json\n{\n  \"url\": \"https://example.com\",\n  \"title\": \"Example Site\",\n  \"description\": \"A useful example website\"\n}\n```\n\n### `search_bookmarks`\nSearch through saved bookmarks.\n\n**Parameters:**\n- `query` (required): Search terms\n\n**Example:**\n```json\n{\n  \"query\": \"python tutorial\"\n}\n```\n\n## Usage Examples\n\nOnce configured with your MCP host, you can use natural language:\n\n- **\"Save this bookmark: https://python.org with title 'Python Official'\"**\n- **\"Search my bookmarks for React tutorials\"**\n- **\"Find bookmarks about machine learning\"**\n- **\"Save https://github.com/microsoft/vscode as a development tool bookmark\"**\n\n## Requirements\n\n- Python 3.11+\n- OpenAI API key\n- `uvx` package manager installed\n- Internet connection for GitHub repository access\n\n## Environment Variables\n\n- `OPENAI_API_KEY`: Required for AI-powered categorization and search enhancement\n\n## Support\n\n- **Issues**: [GitHub Issues](https://github.com/preedew17/mcp-bookmark/issues)\n- **MCP Documentation**: [Model Context Protocol](https://modelcontextprotocol.io/)\n\n## License\n\nMIT License\n\n---\n\n*Built for the Model Context Protocol ecosystem*\n",
  "bytes": 4143,
  "sha": "1d697636973d4daf7ad52c7f748201a97b6d8322dc0923ccc51a2d9aaf134eb5",
  "repo_slug": "preedew17/mcp-bookmark",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_preedew17_mcp_bookmark_2a129070/readme"
}