AI工具集管理

knookit-mcps

个人 AI 工具集——统一管理 Claude Code Skills 和 MCP Server 配置。

每个 Skill 和 MCP 都是独立模块，互不干扰，持续扩展。

项目结构

knookit-mcps/
├── README.md              # 本文件
├── install.sh             # 一键安装脚本
├── skills/                # Claude Code Skills
│   ├── README.md          # Skills 开发指南
│   └── vcoding/           # 四步 AI 协作开发工作流
│       └── SKILL.md
└── mcp/                   # MCP Server 配置
    ├── README.md          # MCP 配置指南
    └── configs/           # 各 MCP 的 JSON 配置
        └── codex.json     # Codex MCP Server

安装

一键安装（推荐）

curl -fsSL https://raw.githubusercontent.com/Authane/knookit-mcps/main/remote-install.sh | bash

重复执行同一命令可自动更新到最新版本（git pull + 重新安装）。

手动安装

git clone https://github.com/Authane/knookit-mcps.git ~/knookit-mcps
cd ~/knookit-mcps

# 查看将执行的操作（不实际执行）
./install.sh --dry-run

# 正式安装
./install.sh

安装脚本会：

1. 检查依赖 — 确认 codex 和 claude CLI 已安装
2. 安装 Skills — 将 skills/ 下每个子目录的 SKILL.md 软链接到 ~/.claude/skills/
3. 合并 MCP 配置 — 将 mcp/configs/ 下所有 JSON 深度合并到 ~/.claude/claude_desktop_config.json（不覆盖已有配置）

使用

vcoding — 四步 AI 协作工作流

安装后在 Claude Code 中说以下任意一句即可触发：

• "vcoding"
• "走四步流程"
• "让 codex 帮我实现"

工作流四步：

所有中间产物保存在项目根目录的 .vcarts/ 中（已自动加入 .gitignore）。

Codex MCP Server

安装后 Claude Desktop / Claude Code 可直接调用 Codex 能力，走 ChatGPT 会员额度，无需配置 API key。

如何新增一个 Skill

1. 在 skills/ 下创建新目录，目录名即 Skill 名称：

mkdir skills/my-new-skill

2. 在目录中创建 SKILL.md，编写 Skill 内容：

touch skills/my-new-skill/SKILL.md

SKILL.md 建议包含：

• 触发条件 — 用户说什么时激活
• 前置准备 — 需要检查或创建的东西
• 工作流 / 步骤 — 具体执行逻辑
• 注意事项 — 边界情况、限制

3. 重新运行安装脚本：

./install.sh

新 Skill 会自动被软链接到 ~/.claude/skills/my-new-skill/SKILL.md。

如何新增一个 MCP

1. 在 mcp/configs/ 下创建新的 JSON 配置文件：

touch mcp/configs/my-server.json

2. 按以下格式编写配置：

{
  "mcpServers": {
    "my-server": {
      "type": "stdio",
      "command": "my-command",
      "args": ["arg1", "arg2"]
    }
  }
}

3. 重新运行安装脚本：

./install.sh

新配置会被深度合并到 ~/.claude/claude_desktop_config.json 中，不影响已有配置。

依赖