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

고성능 Model Context Protocol (MCP) 서버로, AI 코딩 어시스턴트와 자율 에이전트(Claude Code, Claude Desktop, Cursor, Windsurf, Antigravity)를 자체 호스팅 Suwayomi-Server 만화 및 망가 라이브러리에 직접 연결합니다.

? 문제와 해결책

병목 현상

만화, 망가, 라이트노벨 애호가들은 여러 확장 소스(MangaDex, Webtoons, Asura, Flame 등)에서 수백 개의 타이틀과 수천 개의 챕터를 관리하는 경우가 많습니다.

지금까지 AI 에이전트로 이 컬렉션을 관리하는 것은 분산되어 있었습니다:

  • 모바일 Mihon/Tachiyomi는 노출된 API가 없어 취약한 정적 백업 파싱(.tachibk)이 필요하며, 실시간 검색, 변경 사항 기록, 챕터 다운로드를 실행할 수 없습니다.

  • 애그리게이터 UI는 수동 검색, 5개 이상의 확장 탭을 넘기며 클릭, 챕터 업데이트를 수동으로 대기열에 추가해야 합니다.

해결책

suwayomi-mcp가 이 격차를 메웁니다. 표준 JSON-RPC(stdio 전송)를 통해 Suwayomi의 로컬 GraphQL 엔진과 직접 통신함으로써, 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               |
+-------------------------------------------------------------------------+

??? 도구 모음 및 실제 프롬프트

도구

시그니처

채팅에서 요청하는 내용

suwayomi_get_library

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

"내 라이브러리에서 현재 읽지 않은 챕터가 100개 이상인 만화는?"

suwayomi_search_and_add

(query, auto_add_first=False, limit=20)

"내 데이터베이스에서 'Latna Saga'를 찾아 즐겨찾기에 추가해 줘."

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

?? AI 클라이언트 설정

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 Errors: Missing source

  • 원인: 만화가 현재 비활성화되거나 제거된 확장에서 가져온 것입니다.

  • 해결 방법: Suwayomi WebUI -> Browse -> Extensions를 열고 해당 확장이 설치되고 업데이트되었는지 확인하세요.

?? 라이선스

MIT 라이선스. 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