AI导哈

书签管理协议服务器

一个为Linkwarden设计的MCP服务器，用于通过自然语言读取、搜索、组织和清理书签。

  • by ozskywalker
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 ozskywalker/linkwarden-mcp-server

使用说明

linkwarden mcp服务器

MCP（模型上下文协议）服务器 林肯监狱长 --自托管的开源书签管理器。将其连接到Claude，通过自然语言阅读、搜索、组织和清理书签。

特性

  • 浏览和搜索 --列出按集合、标记、日期范围和全文搜索进行筛选的链接
  • 研究 --查找书签以总结、构建新闻通讯或收集上下文
  • 重新分类 --在集合之间移动链接、添加/删除标签、重命名、更新描述
  • 清理 --删除过时的链接、合并重复的标签、重组集合
  • 完整CRUD --创建、读取、更新和删除链接、集合和标记

先决条件

  • 跑步 林肯监狱长 实例（自托管或云）
  • Linkwarden API令牌-在 设置→ 访问令牌
  • Node.js 18+

快速入门（克劳德代码）

将此添加到您的 ~/.claude.json 在...之下 mcpServers:

"linkwarden": {
  "command": "npx",
  "args": ["-y", "linkwarden-mcp-server"],
  "env": {
    "LINKWARDEN_BASE_URL": "https://your-linkwarden-instance.com",
    "LINKWARDEN_API_TOKEN": "your-api-token"
  }
}

或者，如果您在全球范围内安装了它(npm install -g linkwarden-mcp-server):

"linkwarden": {
  "command": "linkwarden-mcp-server",
  "env": {
    "LINKWARDEN_BASE_URL": "https://your-linkwarden-instance.com",
    "LINKWARDEN_API_TOKEN": "your-api-token"
  }
}

环境变量

变量 必填 描述
LINKWARDEN_BASE_URL 是 您的Linkwarden实例的基本URL，例如。 https://linkwarden.example.com
LINKWARDEN_API_TOKEN 是 来自设置的API令牌→ 访问令牌

工具

链接

工具 说明
linkwarden_list_links 按收藏、标签、搜索、日期、固定状态过滤书签列表；支持分页
linkwarden_get_link 按ID获取单个书签的完整详细信息
linkwarden_create_link 保存带有可选名称、描述、集合和标签的新书签URL
linkwarden_update_link 更新书签的名称、URL、描述、收藏、标签或固定状态
linkwarden_delete_link 永久删除书签

集合

工具 说明
linkwarden_list_collections 列出所有集合，以层次结构显示
linkwarden_create_collection 创建一个新的集合，可以选择嵌套在父集合下
linkwarden_update_collection 重命名、重新着色、重新嵌套或更改集合的可见性
linkwarden_delete_collection 删除收藏

标签

工具 说明
linkwarden_list_tags 列出所有标签及其数字ID（过滤所需）
linkwarden_rename_tag 在所有使用标签的链接中重命名标签
linkwarden_delete_tag 从所有链接中删除标签（链接不会被删除）

搜索运算符

linkwarden_list_links 接受a search 支持高级运算符的参数：

操作员 示例 描述
name: name:"product review" 在链接标题中搜索
url: url:github.com 在URL中搜索
tag: tag:ai 按标签名称筛选
collection: collection:research 按集合名称筛选
description: description:security 在描述中搜索
before: before:2025-01-01 日期前保存的链接
after: after:2024-06-01 日期后保存的链接
type: type:pdf 按类型筛选（url、pdf、图像）
pinned:true pinned:true 仅显示固定链接
! !tag:news 否定任何操作员

高级搜索要求在您的Linkwarden实例上配置Meilisearch。

发展

git clone https://github.com/ozskywalker/linkwarden-mcp-server.git
cd linkwarden-mcp-server
npm install
npm run build

在开发过程中以观察模式运行：

LINKWARDEN_BASE_URL=https://your-instance.com \
LINKWARDEN_API_TOKEN=your-token \
npm run dev

贡献

看 贡献.md.

许可证

麻省理工学院——见 许可证.

相关 MCP