legado-mcp-server

legado-mcp-server 是一个把Legado Web API封装成MCP服务的项目，主要是为了方便通过AI编写书源时调试

适用场景

• 把 Legado 接入 Codex、Claude Desktop、Cherry Studio 等 MCP 客户端

Related MCP server: hotlogin-mcp

文档

• Legado Web 接口文档

• MCP 工具说明

环境要求

• Python 3.11+

• 已开启 Legado Web 服务的设备

• 推荐使用 uv

快速开始

安装

1. 下载源码到本地

2. 在项目根目录下执行：

   uv tool install .

   或者直接从 GitHub 安装：

   uv tool install git+https://github.com/joestar817/legado-mcp-server.git

配置

命令行参数：

• --transport: stdio 或 streamable-http (默认为 stdio)

• --host: streamable-http 的监听地址 (默认 127.0.0.1)

• --port: streamable-http 的监听端口 (默认 8000)

• --legado-base-url: Legado HTTP 地址 (如 http://192.168.1.10:1122)

• --legado-ws-url: Legado WebSocket 地址，可选 (如果不指定，默认按 HTTP 端口 + 1 推导)

环境变量：

• LEGADO_BASE_URL

• LEGADO_WS_URL

• LEGADO_HTTP_TIMEOUT: HTTP 请求超时时间 (默认 60s)

• LEGADO_SESSION_BUFFER_SIZE: WebSocket 消息缓冲区大小 (默认 1000)

MCP 客户端接入示例

Codex

[mcp_servers.legado]
command = "legado-mcp-server"
args = ["--legado-base-url", "http://192.168.1.10:1122"]
enabled = true

LM studio

{
  "mcpServers": {
    "legado-mcp-server": {
      "command": "legado-mcp-server",
      "args": [
        "--legado-base-url",
        "http://192.168.1.10:1122"
      ]
    }
  }
}

工具概览

完整参数和返回结构见 MCP 工具说明。

按类别概览：

• 书源：

  • book_source_get

  • book_source_list

  • book_source_save

  • book_source_save_many

  • book_source_delete_many

• RSS：

  • rss_source_get

  • rss_source_list

  • rss_source_save

  • rss_source_save_many

  • rss_source_delete_many

• 替换规则：

  • replace_rule_list

  • replace_rule_save

  • replace_rule_delete

  • replace_rule_test

• 图书：

  • book_save

  • book_delete

  • bookshelf_list

  • book_refresh_toc

  • book_get_chapters

  • book_get_content

  • book_save_progress

  • book_add_local

• 图片与配置：

  • book_get_cover

  • book_get_image

  • web_read_config_get

  • web_read_config_save

• 调试与搜索：

  • book_source_debug

  • rss_source_debug

  • book_search

许可证

MIT