Skip to content

MCP 工具总览

versions-skills 通过 MCP 把全部能力暴露给 AI Agent,共 21 个工具。MCP server 入口为 cmd/versions-mcp,基于 mcp-go

🚀 启动 server

bash
# 从源码构建
go build -o versions-mcp ./cmd/versions-mcp

# 以 stdio 模式启动(默认)
./versions-mcp

🔧 接入 Claude Code / Claude Desktop

在 MCP 配置中添加:

json
{
  "mcpServers": {
    "versions": {
      "command": "/path/to/versions-mcp",
      "args": []
    }
  }
}

接入后,AI 可调用下方任一工具完成版本号操作,无需用户手敲命令。

🧰 工具清单(21 个)

🔍 解析与信息

工具说明
version_parse解析版本字符串为结构化组件
version_validate验证版本字符串是否有效
version_info获取版本号完整信息
version_core获取核心版本号(去后缀)

⚖️ 比较

工具说明
version_compare比较两个版本号

📊 排序与极值

工具说明
version_sort排序版本号列表
version_min查找最小版本
version_max查找最大版本
version_latest_stable最新稳定版本
version_latest_prerelease最新预发布版本

🗃 分组与过滤

工具说明
version_group按数字部分分组
version_filter按条件过滤
version_unique去重
version_set_operation集合运算(差/交/并)

🎯 约束与范围

工具说明
version_constraint_check检查是否满足约束
version_range_query范围查询

🛠 变更与构造

工具说明
version_build从组件构建版本字符串
version_bump递增版本号

📁 文件与可视化

工具说明
version_read_file从文件读取版本号
version_write_file写入版本号到文件
version_visualize文本树状可视化

📐 参数约定

  • 版本号一律以 string 传入(如 "1.2.3""v1.2.3-rc1"
  • 版本号列表以 string[] 传入
  • 布尔 flag 默认 false
  • 所有工具返回 JSON

📚 延伸

基于 MIT 协议发布