📚 Bookmark Manager - Remote MCP Server

A simple bookmark manager built as an MCP (Model Context Protocol) server with PostgreSQL backend.

Features

• ✅ Add bookmarks with URL, title, description, and tags
• 🔍 Search bookmarks by keyword
• 🏷️ Filter bookmarks by tags
• 📊 View bookmark statistics
• 🗑️ Delete bookmarks

Setup

1. Set up PostgreSQL Database

Create a free PostgreSQL database at:

• Neon (Recommended)
• Supabase
• ElephantSQL

2. Configure Environment Variables

Edit .env file and add your database connection string:

DATABASE_URL=postgresql://user:password@host/database

3. Install Dependencies

uv sync

4. Run Locally

uv run main.py

Deploy to FastMCP Cloud

1. Push this repository to GitHub
2. Go to fastmcp.cloud
3. Connect your GitHub repository
4. Set environment variable: DATABASE_URL = your PostgreSQL connection string
5. Deploy!

Available Tools

• add_bookmark(url, title, description, tags) - Add a new bookmark
• view_bookmarks(tag, limit) - View all bookmarks or filter by tag
• search_bookmarks(query) - Search bookmarks
• delete_bookmark(bookmark_id) - Delete a bookmark
• get_stats() - Get bookmark statistics

Example Usage

Add a bookmark: "Save https://fastmcp.cloud as FastMCP Cloud with tags cloud,mcp"
View bookmarks: "Show me all my bookmarks"
Search: "Find bookmarks about python"
Delete: "Delete bookmark with ID 5"
Stats: "Show my bookmark statistics"