Shiori MCP

io.github.rusty4444由 GitHub 账号 rusty4444 发布v0.1.0更新于 Oct 24, 2026

MCP server for Shiori bookmark management and tag workflows.

已验证STDIO仅桌面效率与工作流知识与记忆

概览

AI 生成的概览

让助手管理自建 Shiori 书签库：列出、搜索、新增、更新和删除书签，并管理标签。

可以做什么
连接 Shiori 实例的旧版 /api 接口，提供书签与标签相关工具。可验证连通性与认证、列出书签、按标题、URL、摘要或标签搜索，并按 id 或精确 URL 获取单条书签。写入类工具支持以标签对象新增书签、用完整载荷或常用字段更新、删除单个或多个 id、列出标签及数量、重命名标签，以及列出当前会话可见的账号。
适用场景
适合把书签保存在自建 Shiori 实例中，并希望助手搜索、整理或清理该书签库的场景，例如按标签查找书签、添加带标签的链接，或重命名和清理标签。
运行要求
以 stdio 本地进程运行，从 PyPI 安装 shiori-mcp 并用 uvx 启动（需要 Python 运行时）。需要 SHIORI_BASE_URL，以及 SHIORI_USERNAME 和 SHIORI_PASSWORD，除非提供 SHIORI_SESSION_ID。需要能访问 Shiori 实例的网络；SHIORI_TIMEOUT 可选。
安装前请注意
写入类工具会修改 Shiori 书签数据库，包括按 id 删除书签和重命名标签。SHIORI_PASSWORD 与 SHIORI_SESSION_ID 属于机密，应放在环境变量或密钥管理器中，切勿提交到源码仓库。该服务器面向 Shiori 的旧版 /api 接口。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Shiori MCP，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Shiori MCP

[Buy Me A Coffee]

A Model Context Protocol (MCP) server for Shiori, the self-hosted bookmark and read-it-later manager.

Capabilities

  • Verify Shiori connectivity and authentication
  • List bookmarks
  • Search bookmarks by title, URL, excerpt, and tag
  • Get one bookmark by id or exact URL from the bookmark list
  • Add bookmarks with Shiori's required tag-object format
  • Update bookmarks via either a full-bookmark payload or common field parameters
  • Delete bookmarks by id list
  • List tags and bookmark counts
  • Rename tags
  • List accounts visible to the authenticated session

Installation

bash
pipx install git+https://github.com/rusty4444/shiori-mcp.git

Or from a checkout:

bash
python -m venv .venvsource .venv/bin/activatepip install -e .

Configuration

VariableRequiredDescription
SHIORI_BASE_URLYesBase URL of the Shiori instance, e.g. https://shiori.example.com
SHIORI_SESSION_IDOptionalExisting Shiori session id; skips login if provided
SHIORI_USERNAMERequired unless session id is setShiori username
SHIORI_PASSWORDRequired unless session id is setShiori password
SHIORI_TIMEOUTNoHTTP timeout in seconds, default 20

MCP client config

json
{  "mcpServers": {    "shiori": {      "command": "shiori-mcp",      "env": {        "SHIORI_BASE_URL": "https://shiori.example.com",        "SHIORI_USERNAME": "your-username",        "SHIORI_PASSWORD": "your-password"      }    }  }}

Tools

ToolPurpose
shiori_health_checkVerify API connectivity/authentication
shiori_list_bookmarksList bookmarks with client-side limit/offset
shiori_search_bookmarksSearch bookmarks by text and/or tag
shiori_get_bookmarkGet one bookmark by id from the bookmark list
shiori_get_bookmark_by_urlGet one bookmark by exact URL
shiori_add_bookmarkAdd a bookmark with optional tags/archive/public flags
shiori_update_bookmarkUpdate a bookmark using full Shiori bookmark JSON
shiori_update_bookmark_fieldsUpdate common fields without manually constructing full JSON
shiori_delete_bookmarkDelete one bookmark id
shiori_delete_bookmarksDelete bookmark ids from a JSON array
shiori_list_tagsList tags and bookmark counts
shiori_rename_tagRename a tag
shiori_list_accountsList accounts visible to this session

Development and validation

bash
python -m venv .venvsource .venv/bin/activatepython -m pip install --upgrade pippip install -e '.[dev]'ruff check .pytestpython scripts/live_docs_test.py

live_docs_test.py validates Shiori public API documentation and repository pages without credentials. Authenticated read/write API behaviours are covered with mocked HTTP tests.

Optional LLM validation can be run with any configured OpenAI-compatible endpoint. For local Aeon validation, set AEON_BASE_URL and optionally AEON_MODEL / AEON_API_KEY before running python scripts/model_validate.py.

API note

This server targets Shiori's documented legacy API under /api/* because the new API v1 is still documented as in development and self-documented at /swagger/index.html on running instances.

Safety

The write-capable tools mutate a Shiori bookmark database. Keep credentials in environment variables or a secret manager, never in source control.

This project was developed with the assistance of AI tools.

来源：README.md，提交 005ce95

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分