Skip to main content
Glama
deenesjakoruzh
Augumenter

Suwayomi MCP Server

by Augumenter
OverviewSchemaRelated ServersScoreDiscussions
Local

?? Suwayomi MCP Server

License: MIT Python 3.10+ MCP Standard Suwayomi-Server

AIコーディングアシスタントや自律エージェント(Claude Code、Claude Desktop、Cursor、Windsurf、Antigravity)を、セルフホスト済みのSuwayomi-Serverマンガ・マンファライブラリへ直接接続する、高性能な**Model Context Protocol (MCP)**サーバーです。

?? 問題と解決策

ボトルネック

マンガ、マンファ、ライトノベルの愛好家は、複数の拡張ソース(MangaDex、Webtoons、Asura、Flameなど)をまたいで、何百もの作品と何千ものチャプターを管理しています。

これまで、AIエージェントでこのコレクションを管理するのは断片化されていました:

  • モバイル版Mihon/Tachiyomiは公開APIを持たず、ライブ検索や変更の書き込み、チャプターのダウンロードができない脆い静的なバックアップ解析(.tachibk)に依存する。

  • アグリゲーターUIは、手動検索、5以上の拡張タブをまたいだクリック操作、そして手動でのチャプター更新のキュー登録が必要。

解決策

suwayomi-mcp はこのギャップを埋めます。Suwayomi のローカルGraphQLエンジンと標準JSON-RPC(stdioトランスポート)を介して直接通信することで、AIアシスタントは以下をができるようになります:

  1. ライブラリの状態をリアルタイムに監査する(未読チャプターの滞留数、完読状況、ジャンルを追跡)。

  2. データベース全体で即座に全文検索を実行し、タイトルをお気に入りに一括追加する。

  3. 自然言語の一文だけで、バックグラウンドのチャプター・ダウンロードをキューに入れて起動する。

Related MCP server: Mealie MCP Server

??? システムアーキテクチャ

+-------------------------------------------------------------------------+
|                         LLM / AI ASSISTANT                              |
|           (Claude Desktop, Claude Code, Cursor, Windsurf)               |
+-------------------------------------------------------------------------+
                                     ¦  (Natural Language Intent)
                                     ?
+-------------------------------------------------------------------------+
|                  SUWAYOMI MCP SERVER (FastMCP / Python)                 |
|  • suwayomi_get_library       • suwayomi_search_and_add                 |
|  • suwayomi_download_chapters • suwayomi_get_download_status            |
+-------------------------------------------------------------------------+
                                     ¦  (GraphQL POST JSON / stdio)
                                     ?
+-------------------------------------------------------------------------+
|                  SUWAYOMI-SERVER DAEMON (localhost:4567)                |
|  • GraphQL Resolver           • H2 Database (Library & Metadata)        |
|  • Source Scrapers            • Chapter Downloader Worker               |
+-------------------------------------------------------------------------+

??? ツールスイートと実際のプロンプト例

Tool

eSignature

チャットでの依頼内容

suwayomi_get_library

(in_library_only=True, search=None, limit=50)

"今、ライブラリ内で未読チャプターが100を超えているマンガはどれ？"

suwayomi_search_and_add

(search, auto_add_first=False, limit=20)

"「Latte」がデータベースにあるか探してお気に入りに追加して。"

suwayomi_download_chapters

(manga_id, count=5, unread_only=True, chapter_ids=None)

"Hand Jumper の未読の次の5話をダウンロードして。"

suwayomi_get_download_status

()

"Suwayomiのチャプター・ダウンローダーがまだ実行中か確認して。"

?? 前提条件

  1. Suwayomi-Serverがローカルにインストールされ、ポート4567で起動していること(既定エンドポイント: http://127.0.0.1:4567/api/graphql)。

  2. システムに**Python 3.10+**がインストールされていること。

?? インストールガイド

?? Windowsセットアップ(PowerShell)

# 1. Clone repository
git clone https://github.com/augumenter/suwayomi-mcp.git
cd suwayomi-mcp

# 2. Create and activate virtual environment
python -m venv .venv
.\.venv\Scripts\activate

# 3. Install in editable mode
pip install -e .

# 4. Run automated test suite to verify live connectivity
pytest tests -v

?? macOSセットアップ(Terminal / zsh)

# 1. Clone repository
git clone https://github.com/augumenter/suwayomi-mcp.git
cd suwayomi-mcp

# 2. Create and activate virtual environment
python3 -m venv .venv
source .venv/bin/activate

# 3. Install in editable mode
pip install -e .

# 4. Run automated test suite
pytest tests -v

Linux / Dockerセットアップ(Ubuntu / Debian / Arch)

# 1. Clone repository
git clone https://github.com/augumenter/suwayomi-mcp.git
cd suwayomi-mcp

# 2. Create and activate virtual environment
python3 -m venv .venv
source .venv/bin/activate

# 3. Install package
pip install -e .

# 4. Run tests
pytest tests -v

??

1. Claude Desktop

これをclaude_desktop_config.jsonに追加します:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "suwayomi": {
      "command": "C:\\path\\to\\suwayomi-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "src.server"],
      "cwd": "C:\\path\\to\\suwayomi-mcp",
      "env": {
        "SUWAYOMI_GRAPHQL_URL": "http://127.0.0.1:4567/api/graphql"
      }
    }
  }
}

(macOS/Linuxでは、commandを/path/to/suwayomi-mcp/.venv/bin/pythonに置き換えてください)

2. Claude Code CLI(~/.claude.json)

{
  "mcpServers": {
    "suwayomi": {
      "command": "C:\\path\\to\\suwayomi-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "src.server"],
      "cwd": "C:\\path\\to\\suwayomi-mcp",
      "env": {
        "SUWAYOMI_GRAPHQL_URL": "http://127.0.0.1:4567/api/graphql"
      }
    }
  }
}

3. Cursor(.cursor/mcp.json)

{
  "mcpServers": {
    "suwayomi": {
      "command": "python",
      "args": ["-m", "src.server"],
      "env": {
        "SUWAYOMI_GRAPHQL_URL": "http://127.0.0.1:4567/api/graphql"
      }
    }
  }
}

?? 実際の会話例

例1: ライブラリの監査とおすすめ

User: "Check my library and recommend something intense to read from my unread backlog."

Agent: "I checked your Suwayomi library. Here are your top unread thriller & action series:
1. Hand Jumper (130 unread chapters) - Thriller / Supernatural
2. Psychopath in Murim (30 unread chapters) - Action / Fantasy
3. Lookism (1,237 unread chapters) - Action / Delinquents

Would you like me to queue the next 5 chapters of Hand Jumper for offline reading?"

例2: タイトルの自動取り込み

User: "Find Latna Saga and make sure it is added to my library favorites."

Agent: "Found 'Latna Saga: Survival of a Sword King' (ID: 38).
I executed the updateManga mutation and set inLibrary: true. It is now tracked in your favorites."

例3: チャプターの一括ダウンロード

User: "Download the next 10 unread chapters of Omniscient Reader."

Agent: "Fetched unread chapter IDs [412, 413, 414, 415, 416, 417, 418, 419, 420, 421].
Dispatched enqueueChapterDownloads mutation and triggered the downloader daemon.
Download status: STARTED (10 items in queue)."

?? インタラクティブなニューラルネットワーク・ビジュアライザー

このプロジェクトには、MCP ブリッジの全レイヤーを通過するパケットを可視化する、リアルタイムでアニメーションするニューラル・シナプス・グラフ(Neural Synaptic Graph) が含まれています。

ビジュアライザーを起動するには:

python -m http.server 8080 --directory visualizer

ブラウザで**http://localhost:8080**を開くと、動きのあるノードと対話し、シナプスのパルス列を発火し、ライブのペイロード通信量(テレメトリ)を確認できます。

?? トラブルシューティングFAQ

Unable to connect to Remote Server (127.0.0.1:4567)

  • 原因: Suwayomi-Serverが起動していません。

  • 対応: ローカルの Suwayomi デーモン(WindowsならSuwayomi Launcher.bat、ターミナルならsuwayomi-server)を起動し、http://localhost:4567がブラウザーで表示されることを確認してください。

GraphQL Error: Missing source

  • 原因: 現在無効またはアンインストールされている拡張から取り込まれたマンガです。

  • 対応: Suwayomi WebUI -> Browse -> Extensions を開き、対応する拡張がインストールされ、更新されていることを確認してください。

?? ライセンス

MIT License. Copyright (c) 2026 Ileri Nwajei (@augumenter)。

This server cannot be installed

A
license - permissive license
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • GitHub

    Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.

  • Hint-Services-obsidian-github-mcp

    Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…

  • LLMemory

    Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Augumenter/suwayomi-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server