book-mcp/frontend

book-mcp Frontend

DoLuEdu Arco Admin Vue 管理端骨架 + book-mcp 业务模块。

启动

# 1. 确保 book-mcp server 在跑 (8100)
# 2. 装依赖
npm install

# 3. dev server
npm run dev    # http://localhost:5176

# 4. 构建生产
npm run build

配置

• vite.config.dev.ts — dev proxy /mcp → http://localhost:8100/mcp
• .env.development — VITE_API_BASE_URL=/mcp（用相对路径走 proxy）

业务模块

• src/api/mcp.ts — JSON-RPC 客户端（fastmcp 协议）
• src/api/book.ts — book CRUD
• src/api/document.ts — document / file CRUD + health
• src/views/BookManage/index.vue — 列表页（路由 /book/list）
• src/views/BookManage/BookDetail/index.vue — 详情页（路由 /book/:id）
• src/views/BookManage/components/BookList.vue — 列表组件
• src/views/BookManage/components/DocumentItem.vue — 文档折叠项

MCP 后端

15 个工具，分类：

类别	工具
写入	create_book / add_document / mark_html_ready / mark_json_ready / mark_failed / update_book_status
查询	get_book / list_books / get_document / list_documents / get_document_url
辅助	upload_to_rustfs / soft_delete_book / retry_failed
诊断	health

启动：launchd ai.book-mcp.server（端口 8100，stateless_http + json_response）。

模板来源

DoLuEdu-Template/frontend/arco-admin-vue/ 复制而来。模板规则：禁止在模板里写业务，只在骨架基础上加。

关键约定

• Vue 3 + TypeScript + <script setup>
• Arco Design Vue 2.x
• 目录 PascalCase（BookManage/ 不是 book-manage/）
• API 用 axios 包 fastmcp JSON-RPC