Linkwarden 인스턴스에 프로그래밍 액세스를 제공하는 모델 Context Protocol (MCP) 서버. Linkwarden은 자체 호스팅 책갈피 관리 서비스이며, 이 MCP 서버는 Linkwarden의 책갈피 수집, 링크 및 검색 기능과 상호 작용하는 AI 에이전트를 가능하게 합니다.

특징

-Collection Management: 전체 API 지원으로 수집, 읽기 및 삭제

• 링크 관리: 생성, 읽기, 아카이브 및 종합 기능으로 링크 삭제
• Tag Management: ID로 모든 태그와 삭제 태그를
• Advanced Search: 강력한 필터링 및 질화로 링크 검색
• Public Collection Access: 공공 컬렉션 및 메타데이터 접근 -Toolset Selectivity: 필요한 도구만 사용 가능
• Read-Only Mode: 생산 환경의 선택적 안전 모드
• Flexible Configuration: command-line flags, 환경 변수 및 설정 파일 지원

데모

Claude 코드

사용 가능한 도구

Few 예제 사용

저장 링크:

검색 링크:

설치

# 필수품

• Linkwarden 인스턴스에 대한 액세스 (자기 호스팅 또는 클라우드)
• 적절한 권한을 가진 Linkwarden API 토큰

# # # # A.

linkwarden-mcp-server

A Model Context Protocol (MCP) server that provides AI assistants with programmatic access to Linkwarden instances. Linkwarden is a self-hosted bookmark management service, and this MCP server enables AI agents to interact with Linkwarden’s bookmark collections, links, and search functionality.

Features

• Collection Management: Create, read, and delete collections with full API support
• Link Management: Create, read, archive, and delete links with comprehensive functionality
• Tag Management: Get all tags and delete tags by ID
• Advanced Search: Search links with powerful filtering and pagination
• Public Collection Access: Access public collections and their metadata
• Toolset Selectivity: Enable only the tools you need
• Read-Only Mode: Optional safety mode for production environments
• Flexible Configuration: Support for command-line flags, environment variables, and config files

Demo

Claude Code

Available Tools

Few Example Usage

Save link:

Search Link:

Installation

Prerequisites

• Access to a Linkwarden instance (self-hosted or cloud)
• Linkwarden API token with appropriate permissions

A. Using Docker (Recommended)

The easiest way to use linkwarden-mcp-server is via Docker. Pre-built images are available on GitHub Container Registry.

Pull the latest image

docker pull ghcr.io/irfansofyana/linkwarden-mcp-server:latest

Pull a specific version

# Pull a specific version (e.g., v1.0.0)
docker pull ghcr.io/irfansofyana/linkwarden-mcp-server:1.0.0

# Or with 'v' prefix
docker pull ghcr.io/irfansofyana/linkwarden-mcp-server:v1.0.0

Available tags:

• latest - Latest stable release from main branch
• v{major}.{minor}.{patch} - Specific version (e.g., v1.0.0)
• {major}.{minor}.{patch} - Specific version without ‘v’ prefix (e.g., 1.0.0)
• {major}.{minor} - Latest patch for minor version (e.g., 1.0)
• {major} - Latest minor and patch for major version (e.g., 1)

B. Build from Source

If you prefer to build from source:

git clone https://github.com/irfansofyana/linkwarden-mcp-server.git
cd linkwarden-mcp-server
make build

Prerequisites for building:

• Go 1.23 or later
• Make

C. Using Go Install

go install github.com/irfansofyana/linkwarden-mcp-server/cmd/linkwarden-mcp-server@latest

Configuration

The server can be configured using command-line flags, environment variables, or a configuration file.

Required Configuration

• --base-url: Your Linkwarden instance URL (or LINKWARDEN_BASE_URL environment variable)
• --token: Your Linkwarden API token (or LINKWARDEN_TOKEN environment variable)

Optional Configuration