LANraragi MCP Server

封装 LANraragi 全部 API 的 MCP 服务 — 51 个工具，让 AI agent 浏览、搜索、上传、打标、管理漫画存档。

基于 LANraragi 的 Model Context Protocol 服务端。

快速开始

{
  "mcpServers": {
    "lanraragi": {
      "transport": "streamable_http",
      "url": "http://你的服务器:3001/mcp",
      "headers": {
        "LRR-API-Key": "你的API密钥"
      }
    }
  }
}

环境变量

变量	默认值	说明
LRR_URL	http://localhost:3000	LANraragi 服务器地址
LRR_API_KEY	空	API 密钥，🔑 端点必需
MCP_PORT	3001	HTTP 服务端口
MCP_HOST	0.0.0.0	HTTP 绑定地址

运行方式

HTTP 模式（远程客户端）

env LRR_URL=http://localhost:3000 MCP_PORT=3001 node dist/http.js

Stdio 模式（本地客户端）

env LRR_URL=http://localhost:3000 node dist/stdio.js

systemd 服务

cp lanraragi-mcp.service ~/.config/systemd/user/
systemctl --user daemon-reload
systemctl --user enable --now lanraragi-mcp

构建

npm install
npm run build

工具列表（51 个）

详见 SKILL.md。

模块	数量	核心工具
搜索	4	search_archives, search_random
存档	18	list_archives, upload_archive, download_url, extract_archive
数据库	1	get_tag_stats
分类	7	list_categories, add_archive_to_category
单行本	10	list_tankoubons, create_tankoubon
文件监控	4	get_shinobu_status, rescan_shinobu
任务队列	3	get_job_status, queue_job
杂项	4	get_server_info, download_url, regen_thumbnails

配套服务

• 文件服务器：为 download_url 提供带 Content-Disposition 头的文件下载，可与 MCP 同机部署
• LANraragi：漫画图书馆本体，通过 LRR_URL 配置连接

许可

MIT