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 取得單一書籤。寫入類工具支援以標籤物件新增書籤、用完整 payload 或常用欄位更新、刪除單一或多個 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 分