rossshannon/pinboard-bookmarks-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

10 stars 3 forks 품질 81 트렌드 32MIT

Repository Install

Pinboard bookmarks MCP server

개요

Read-only access to Pinboard.in bookmarks for LLMs via Model Context Protocol (MCP). This server provides LLMs with the ability to search, filter, and retrieve bookmark metadata from Pinboard.in at inference time. Built on FastMCP, it offers five tools for bookmark interaction while respecting Pinboard's rate limits and implementing intelligent caching. - to Pinboard bookmarks - : search_bookmarks, search_bookmarks_extended, list_recent_bookmarks, list_bookmarks_by_tags, list_tags - with LRU cache and automatic invalidation using posts/update endpoint - respects Pinboard's 3-second guideline between API calls - converts Pinboard's legacy field names to intuitive ones (description→title, extended→notes) - for MCP Apps hosts: bookmarks and tags render as interactive cards in Claude, ChatGPT and other hosts that support MCP Apps; other hosts see plain results as before - with integration test harnesses and CI validation 1. from https://pinboard.in/settings/password 2. : 3. : 4.

README

원문 README의 일부입니다. 원문 보기.

Pinboard MCP Server

Read-only access to Pinboard.in bookmarks for LLMs via Model Context Protocol (MCP).

Overview

This server provides LLMs with the ability to search, filter, and retrieve bookmark metadata from Pinboard.in at inference time. Built on FastMCP, it offers five tools for bookmark interaction while respecting Pinboard’s rate limits and implementing intelligent caching.

Features

Read-only access to Pinboard bookmarks
Five MCP tools: search_bookmarks, search_bookmarks_extended, list_recent_bookmarks, list_bookmarks_by_tags, list_tags
Smart caching with LRU cache and automatic invalidation using posts/update endpoint
Rate limiting respects Pinboard’s 3-second guideline between API calls
Field mapping converts Pinboard’s legacy field names to intuitive ones (description→title, extended→notes)
Result cards for MCP Apps hosts: bookmarks and tags render as interactive cards in Claude, ChatGPT and other hosts that support MCP Apps; other hosts see plain results as before
Comprehensive testing with integration test harnesses and CI validation

Installation

Via pip (recommended)

pip install pinboard-bookmarks-mcp-server

From source

git clone https://github.com/rossshannon/pinboard-bookmarks-mcp-server.git
cd pinboard-bookmarks-mcp-server
pip install -e .

Quick Start

Get your Pinboard API token from https://pinboard.in/settings/password

Set environment variable:

export PINBOARD_TOKEN="username:1234567890ABCDEF"

Start the server:
```
pinboard-mcp-server
```

Verify it’s working:

# Test help command (works without token)
pinboard-mcp-server --help

# Server should show "Starting MCP server" when run with token

Usage with Claude Desktop

Add this configuration to your Claude Desktop settings:

{
  "mcpServers": {
    "pinboard": {
      "command": "pinboard-mcp-server",
      "env": {
        "PINBOARD_TOKEN": "your-username:your-token-here"
      }
    }
  }
}

Available Tools

1. `search_bookmarks`

Search bookmarks by query string across titles, notes, and tags. Recent-focused with automatic expansion.

Parameters:

query (string): Search query
limit (int, optional): Maximum results (default: 20, max: 100)

Example:

Search for "python testing" bookmarks

2. `search_bookmarks_extended`

Extended search for comprehensive historical results across titles, notes, and tags.