Metadata-Version: 2.4
Name: mcp-bookmark-server
Version: 0.1.2
Summary: MCP server to save and search bookmarks using OpenAI RAG
Author-email: Preeti Dewani <preetidewani1990@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/pree-dew/mcp-bookmark
Project-URL: Repository, https://github.com/pree-dew/mcp-bookmark
Project-URL: Bug Tracker, https://github.com/pree-dew/mcp-bookmark/issues
Keywords: mcp,bookmark,openai,rag,search,server
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: mcp[cli]>=1.13.1
Requires-Dist: openai>=1.106.1

# MCP Bookmark Server

mcp-name: io.github.pree-dew/mcp-bookmark

A 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.

## Features

- **Save Bookmarks**: Store URLs with titles and descriptions
- **Smart Search**: Search across bookmark titles and descriptions using semantic search
- **AI-Powered**: Integration with OpenAI for intelligent bookmark management and categorization
- **Multi-Platform**: Easy integration across multiple MCP-compatible platforms

## Installation

```bash
pip install mcp-bookmark-server
```

## Configuration for MCP Hosts

### Claude Desktop

Add to your `claude_desktop_config.json`:

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

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

### Cursor IDE

Add to your MCP settings in `.cursor/mcp_config.json`:

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

### Windsurf IDE

Add to your `windsurf_config.json`:

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

### Zed Editor

Add to your Zed settings under MCP servers:

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

### Continue (VS Code Extension)

Add to your `continue/config.json`:

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

## Available Tools

### `save_bookmark`
Save a new bookmark.

**Parameters:**
- `url` (required): The URL to bookmark
- `title` (optional): Title for the bookmark
- `description` (optional): Description

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

### `search_bookmarks`
Search through saved bookmarks.

**Parameters:**
- `query` (required): Search terms

**Example:**
```json
{
  "query": "python tutorial"
}
```

## Usage Examples

Once configured with your MCP host, you can use natural language:

- **"Save this bookmark: https://python.org with title 'Python Official'"**
- **"Search my bookmarks for React tutorials"**
- **"Find bookmarks about machine learning"**
- **"Save https://github.com/microsoft/vscode as a development tool bookmark"**

## Requirements

- Python 3.11+
- OpenAI API key
- `uvx` package manager installed
- Internet connection for GitHub repository access

## Environment Variables

- `OPENAI_API_KEY`: Required for AI-powered categorization and search enhancement

## Support

- **Issues**: [GitHub Issues](https://github.com/pree-dew/mcp-bookmark/issues)
- **MCP Documentation**: [Model Context Protocol](https://modelcontextprotocol.io/)

## License

MIT License

---

*Built for the Model Context Protocol ecosystem*
