{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_7rmsqrch2k73","handle":"batch-rename-mcp","url":"https://wellknown.network/agents/batch-rename-mcp","links":{"self":"https://wellknown.network/agents/batch-rename-mcp/record.json","html":"https://wellknown.network/agents/batch-rename-mcp","markdown":"https://wellknown.network/agents/batch-rename-mcp/record.md","api":"https://wellknown.network/api/v1/agents/batch-rename-mcp","status":"https://wellknown.network/api/v1/agents/batch-rename-mcp/status","claim":"https://wellknown.network/agents/batch-rename-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/batch-rename-mcp/claim.json","badge":"https://wellknown.network/agents/batch-rename-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:batch-rename-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"batch-rename-mcp","summary":"批量文件重命名MCP服务器 - 功能强大、安全可靠的文件重命名工具","description":"# 批量文件重命名 MCP 服务器\n\n[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://python.org)\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n[![MCP Protocol](https://img.shields.io/badge/MCP-compatible-purple.svg)](https://github.com/anthropics/model-context-protocol)\n\n功能强大、安全可靠的文件批量重命名工具，基于 MCP (Model Context Protocol) 构建，支持多种重命名模式和安全预览。\n\n## ✨ 核心特性\n\n### 🎯 多样化重命名模式\n- **模板变量**: 使用 `{name}`, `{counter}`, `{date}`, `{time}` 等变量\n- **正则表达式**: 支持复杂的模式匹配和替换，包括捕获组\n- **大小写转换**: `upper:`, `lower:`, `title:` 转换文件名大小写\n- **序号格式化**: 支持零填充格式如 `{counter:03d}`\n\n### 🛡️ 安全性保障\n- **预览模式**: 执行前预览所有更改，避免意外操作\n- **路径安全验证**: 防止路径遍历攻击和非法文件名\n- **原子性操作**: 操作失败时自动回滚，保证文件系统一致性\n- **冲突解决**: 智能处理文件名冲突，支持跳过、覆盖、自动编号\n\n### 📋 操作日志管理\n- **完整日志记录**: 记录每次重命名操作的详细信息\n- **一键撤销**: 支持撤销最近的重命名操作\n- **历史查询**: 查看操作历史和统计信息\n\n### 🔍 文件扫描功能\n- **智能扫描**: 支持递归扫描和文件类型过滤\n- **详细信息**: 显示文件大小、修改时间、权限等信息\n- **性能优化**: 支持最大文件数限制，避免内存溢出\n\n## 🚀 快速开始\n\n### 安装要求\n\n- Python 3.10 或更高版本\n- MCP 1.0.0 或更高版本\n\n### 安装方式\n\n```bash\n# 使用 pip 安装\npip install batch-rename-mcp\n\n# 或者从源码安装\ngit clone https://github.com/fengjinchao/batch-rename-mcp.git\ncd batch-rename-mcp\npip install -e .\n```\n\n### 基本使用\n\n```bash\n# 启动 MCP 服务器\nbatch-rename-mcp\n\n# 或者使用 Python 模块方式\npython -m src.server\n```\n\n## 📖 使用指南\n\n### 1. 批量重命名工具 (batch_rename)\n\n#### 基本语法\n```json\n{\n  \"target\": \"/path/to/files\",\n  \"pattern\": \"重命名模式\",\n  \"options\": {\n    \"dry_run\": true,\n    \"recursive\": false,\n    \"file_filter\": \"*.jpg\",\n    \"conflict_resolution\": \"auto_number\"\n  }\n}\n```\n\n#### 重命名模式详解\n\n##### 模板变量模式\n```bash\n# 添加序号\n\"photo_{counter:03d}\"           # photo_001.jpg, photo_002.jpg\n\n# 使用原文件名\n\"backup_{name}\"                 # backup_image.jpg\n\n# 添加日期时间\n\"IMG_{date}_{counter}\"          # IMG_20240919_1.jpg\n\n# 组合使用\n\"{date}_{name}_{counter:02d}\"   # 20240919_photo_01.jpg\n```\n\n##### 正则表达式模式\n```bash\n# 基本替换\n\"regex:^test:fjc1\"              # test_file.jpg -> fjc1_file.jpg\n\n# 忽略大小写\n\"regex:IMG:PHOTO:i\"             # IMG_123.jpg -> PHOTO_123.jpg\n\n# 使用捕获组\n\"regex:IMG…","publisher":null,"homepage":null,"repository":null,"version":"1.0.2","license":"MIT","protocols":["mcp"],"tags":["batch","files","mcp","rename","tool","utility"],"pricing":null,"endpoints":[{"url":"pypi:batch-rename-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.filesystem","name":"Filesystem","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"fr"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"batch-rename-mcp","registry":"pypi","observedAt":"2026-09-09T10:29:38.666Z","publishedAt":"2026-01-15T07:35:46.972524Z","latestVersion":"1.0.2"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"batch-rename-mcp","url":"https://pypi.org/project/batch-rename-mcp/","firstSeenAt":"2026-09-09T10:26:41.845Z","fetchedAt":"2026-09-09T10:26:41.845Z","normalizedAt":"2026-09-09T10:26:41.845Z"}]},"firstSeenAt":"2026-09-09T10:26:41.845Z","updatedAt":"2026-09-09T10:29:38.666Z"}