jmcomic-ai

JMComic AI provides an MCP-based integration that exposes core JMComic-Crawler capabilities (such as search, download, ranking, and option updates) to AI agents and local editors. Through the MCP protocol, you can drive the JMComic toolkit from an AI client using standard MCP transports (stdio, SSE, or HTTP). This server also supports Skills that inject practical usage knowledge for tasks like handling common errors, avoiding duplicate downloads, and optimizing download options. With the tools available, you can perform fuzzy searches, sort results by popularity or views, request batch downloads, adjust concurrency, and modify option configurations on the fly. The combined MCP tools and Skills enable natural-language workflows such as: asking the agent to search for a specific author’s works, download the top results, or tune the download threading to accelerate transfers, all without writing code.

Prerequisites:

• Python 3.12 (as indicated by the project badges) or a compatible runtime
• Internet access to install dependencies from PyPI (uv/pip) or access to the repository for source installation

Option A – Install via uv (recommended):

1. Install the package with uv

uv add jmcomic-ai

2. (Optional) Install via uv tool:

uv tool install jmcomic-ai

Option B – Install via pip:

# Python package install
pip install jmcomic-ai

Option C – Install from source (recommended if you want local development):

git clone https://github.com/hect0x7/JMComic-ai.git
cd JMComic-ai
uv sync         # manage dependencies with uv (preferred)

After installation, you can start the MCP server using the chosen transport (SSE in this example) as described in the mcp_config section.

Notes and tips:

• The recommended transport is SSE for desktop AI clients; you can switch to stdio or HTTP as needed.
• By default, SSE runs on http://127.0.0.1:8000/sse and HTTP on http://127.0.0.1:8000/mcp. Adjust your client configuration accordingly.
• Skills can be installed to ~/.claude/skills/jmcomic to provide the AI with domain-specific guidelines. Use jmai skills install to set this up.
• If you modify option.yml or other configuration files, changes can be hot-reloaded by the MCP server depending on your transport and setup.
• Ensure network access is permitted for your client to reach the MCP endpoint, especially when deploying locally or in a remote environment.
• The npm_package field is null since JMComic AI is Python-based; there is no corresponding npm package for this MCP server.