Jmcomic Ai

🚀 JMComic AI

こんな時代、まだ従来の方法で漫画を見ていますか？「人机交互」から「人智交互」へ、あなたのすべての漫画ニーズをAIに任せましょう！

⚠️ 重要提示

もしあなたがこのプロジェクトにコードを貢献したい場合は、必ず を確認してください。このガイドには、開発環境のセットアップ、プロジェクト構造の説明、reference 参考ソースコードライブラリの使用方法が含まれています。

🚀 クイックスタート

JMComic AI を使えば、自然言語で漫画を検索、フィルタリング、ダウンロードできます。以下の手順に従って、すぐに始めましょう。

✨ 主な機能

• 🔌 MCP 標準統合 - FastMCP をベースに構築され、stdio、SSE、HTTP などのさまざまな伝送方式をサポートし、ほとんどの現代的なローカル AI クライアント（Cursor、Antigravity、Windsurf、Zed、Claude Desktop など）と互換性があります。
• 🛠️ 全機能ツールセット - search、download、ranking、update_option などの核心機能を公開し、AI が直接 jmcomic を操作できるようにします。
• 📚 知識リソース (Resources) - 設定スキーマ、リファレンスドキュメント、Skills マニュアルを提供し、AI がツールを正しく使用する方法を理解できるようにします。
• ⚙️ 自然言語設定 - AI が option.yml 設定を理解し、動的に変更できます（例：回線の切り替え、ダウンロードルールの調整）。
• 🎯 統一 CLI - jmai / jmcomic-ai コマンドラインツールを提供し、MCP サービスの起動、設定の閲覧、Skills のインストールを統一的に管理できます。
• 🔮 将来の計画 - OCR (MangaOCR)、神経機械翻訳 (NMT)、ベクトル検索 (RAG) の統合を計画し、画面ベースの意味検索を実現します。

📦 インストール

1、pypi からインストール（推奨）

# uv を使用する（推奨）
uv add jmcomic-ai
# または
uv tool install jmcomic-ai

# pip を使用する
pip install jmcomic-ai

2、ソースコードからインストール

uv を使用して依存関係を管理することを推奨します。

# プロジェクトをクローンする
git clone https://github.com/hect0x7/JMComic-ai.git
cd JMComic-ai

# 依存環境を同期する
uv sync

💻 使用例

基本的な使用法

以下の例は cursor/antigravity と mcp モードに基づいています。

高度な使用法

1. 智能検索とダウンロード

🤔 "作者 [XXX] の作品を検索し、閲覧数でソートして、上位 5 つの人気漫画をダウンロードしてください。"
🤖 **Agent**: `search_album` を自動的に呼び出してリストを取得し、`views` でソートして上位 5 つを取得し、`download_album` を並列で呼び出します。

🤔 "ダウンロード速度が遅いので、画像の並列数を 50 に変更してください。"
🤖 **Agent**: 意図を理解し、`update_option` を呼び出して `download.threading.image: 50` を変更し、リアルタイムで有効にします。

2. 曖昧な決定

🤔 "ある作品と似たスタイルの短編漫画を探して、3 章以内のものを教えてください。"
🤖 **Agent**: 意味検索とメタデータフィルタリングを組み合わせて、あなたの好みに合った閲覧リストを推薦して整理します。

📚 ドキュメント

🔌 モジュール A：MCP ツールの接続（推奨）

📂 クライアント設定ファイルの場所ガイド

1. stdio モード（最も簡単）

{
  "mcpServers": {
    "jmcomic-ai": {
      "command": "jmai",
      "args": ["mcp", "stdio"]
    }
  }
}

ソースコードをクローンし、ローカルソースコードを使用してインストールする場合は、次のように設定します。

{
  "mcpServers": {
    "jmcomic-ai": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/jmcomic-ai",
        "run",
        "jmai",
        "mcp",
        "stdio"
      ]
    }
  }
}

⚠️ 重要提示

/path/to/your/jmcomic-ai をローカルソースコードの実際の絶対パスに置き換えてください。

2. SSE モード（推奨）

jmai mcp sse  # デフォルトポート 8000

{
  "mcpServers": {
    "jmcomic-ai": {
      "url": "http://127.0.0.1:8000/sse"
    }
  }
}

3. HTTP ストリーミングモード（本番/リモート）

jmai mcp http

{
  "mcpServers": {
    "jmcomic-ai": {
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

4. 設定完了後

• 汎用クライアント：クライアントを再起動し、ステータスインジケータまたはツールバー（通常は 🔨 アイコンで表示）を確認します。
• Claude Code：ターミナルで次のコマンドを実行して接続を検証します。

claude mcp list

jmcomic-ai (connected) が表示されれば、設定は成功です。

🧠 モジュール B：Agent への「経験」注入

jmai skills install

技能ファイルはデフォルトで ~/.claude/skills/jmcomic にインストールされます。

このディレクトリの SKILL.md の内容を AI に提供する（例：System Prompt または Project Instructions にコピーする）か、MCP Resource をサポートするクライアントで直接 jmcomic://skill を閲覧します。

第三步：会話の開始

上記の 2 つの手順を完了すると、AI は専門の漫画コレクターになります。次のような会話を試してみてください。

• 曖昧な検索：

“私が見たいのは...主人公がチェンソーマンの漫画を探してください。”
(AI は自動的に 'チェンソーマン' を検索し、最も関連性の高い結果を表示します)

• 一括ダウンロード：

“検索結果の中で閲覧数が最も多い上位 3 つをダウンロードしてください。”
(AI は検索結果を分析し、上位 3 つを選択し、自動的にダウンロードツールを呼び出します)

• 設定の変更：

“ダウンロードが遅いので、並列数を 50 に変更してください。”
(AI は設定ツールを呼び出し、自動的に option.yml を変更します)

🔧 よく使うコマンドの参考

MCP サービス管理

jmai mcp              # SSE サービスを起動する（推奨方法、デフォルトポート 8000）
jmai mcp --reload     # ホットリロード付きのサービスを起動する（コードを変更すると自動的に再起動する）
jmai mcp http         # Streamable HTTP サービスを起動する（専門家推奨、本番デプロイをサポートする）
jmai mcp stdio        # stdio サービスを起動する（従来の子プロセス/パイプモード）

Skills 管理

jmai skills install   # Skills をデフォルトディレクトリ (~/.claude/skills/jmcomic) にインストールする

設定ファイル管理

jmai option show      # 現在の設定内容を表示する
jmai option path      # 設定ファイルのパスを表示する
jmai option edit      # エディタを呼び出して設定を変更する

ヘルプの表示

jmai --help           # すべてのコマンドを表示する
jmai mcp --help       # MCP コマンドのヘルプを表示する

🔧 技術詳細

graph TD
    User[User / AI Agent] <-->|MCP Protocol| Server[JMAI MCP Server]
    Server <-->|Call| Core[Core Service Layer]
    Core <-->|Invoke| Lib[JMComic Crawler Lib]
    Server <-->|Load| Skills["Agent Skills (Instructional Knowledge)"]
    Core -->|Read/Write| Config[Option System]

📖 項目紹介

JMComic AI は JMComic-Crawler-Python のための MCP (Model Context Protocol) サポート と AI Skills 拡張 を提供します。

従来のクローラーツールは効率的ですが、曖昧な要求を処理するのに苦労することがあります。正確な ID やキーワードを覚えておく必要があり、さまざまなパラメータを手動で設定する必要があります。

このプロジェクトは 2 つの側面からこの問題を解決します。

1. MCP ツールの統合 - jmcomic の核心機能（検索、ダウンロード、ランキングなど）を標準的な MCP ツールにカプセル化し、ローカルの AI エージェント/エディタ（Cursor、Antigravity、Windsurf、Zed、Claude Desktop など）が直接呼び出せるようにします。
2. Skills 知識の注入 - 使い方ガイドとベストプラクティスを提供し、AI がこれらのツールを正しく使用する方法を理解できるようにします。

これで、コードを書かずに、自然言語で漫画を検索、フィルタリング、ダウンロードできます。

📄 ライセンス

このプロジェクトは GitHub license の下で公開されています。