mcpField
C
cli-anything-ccswitch

cli-anything-ccswitch

github.com/hkudsAgent 工作流57.6k217 次安装5 周前更新
代码仓库

关于 cli-anything-ccswitch

CC Switch CLI 是用于管理 CC Switch 桌面应用配置数据库的命令行工具，该应用面向 AI 编码工具。它支持提供商和代理设置、MCP 服务控制、技能、使用记录及会话浏览，并提供 JSON 输出供程序处理。

主要功能

  1. 01管理 AI 提供商配置
  2. 02查看和配置本地代理
  3. 03列出并启用 MCP 服务
  4. 04浏览技能和仓库
  5. 05查看使用统计与会话

适用场景

  1. 01切换编码工具的当前提供商
  2. 02为应用启用 MCP 服务
  3. 03检查 API 使用情况和对话会话

MCP 相关

该命令行工具可列出 CC Switch 中配置的 MCP 服务，并为指定应用启用服务。这些操作会管理 CC Switch 数据库中的服务配置。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-ccswitch

安装后在 Claude Code 中输入/cli-anything-ccswitch确认已加载。

详细介绍

CC Switch CLI

CC Switch 的 CLI 工具，CC Switch 是一款桌面应用，用于管理 AI 编码工具（Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes）的配置。基于 Click 和 CLI-Anything 方法论构建。

前提条件

  • Python 3.10+
  • 已安装 CC Switch，并在 ~/.cc-switch/cc-switch.db 处有一个可用的数据库

安装

pip install -e .

安装后，命令 cli-anything-ccswitch 即可使用。

命令组

命令组描述
status显示数据库的快速概览
providers管理 AI 提供商配置（list、get、set-current）
proxy管理本地 HTTP 代理服务（status、config）
mcp管理 MCP（Model Context Protocol）服务（list、enable）
skills管理已安装的技能（list、repos）
usage查看 API 用量和费用统计（stats、logs）
settings查看和管理 CC Switch 设置（list、get、set）
sessions浏览和搜索 AI 对话会话（list）

全局选项

  • --json — 以机器可读的 JSON 格式输出（推荐 Agent 使用）
  • --db PATH — 覆盖数据库路径

Agent 专用指南

JSON 输出

以编程方式使用时应始终加上 --json。将其放在子命令之前：

cli-anything-ccswitch --json providers list
cli-anything-ccswitch --json usage stats --days 30
cli-anything-ccswitch --json providers get <id> --app claude
敏感值

API token、密钥和机密在所有输出中均会被掩码。提供商详情中的 settings_config 字段显示掩码后的值（例如 sk-bc089...5cbb）。

退出码
  • 0 — 成功
  • 1 — 错误（例如资源未找到、应用类型无效）
应用类型

有效应用类型：claude、codex、gemini、opencode、openclaw、hermes。

示例

列出所有提供商
cli-anything-ccswitch providers list
cli-anything-ccswitch --json providers list --app claude
切换当前提供商
cli-anything-ccswitch providers set-current <provider-id> --app claude
检查代理状态
cli-anything-ccswitch proxy status --app claude
cli-anything-ccswitch proxy config --app claude --set-port 8080
查看用量统计
cli-anything-ccswitch usage stats --days 7
cli-anything-ccswitch --json usage stats --days 30 --app claude
cli-anything-ccswitch usage logs --limit 10
列出技能
cli-anything-ccswitch skills list
cli-anything-ccswitch skills repos
MCP 服务
cli-anything-ccswitch mcp list
cli-anything-ccswitch mcp enable <server-id> --app claude --on
设置
cli-anything-ccswitch settings list
cli-anything-ccswitch settings get <key>
cli-anything-ccswitch settings set <key> <value>
会话
cli-anything-ccswitch sessions list --app claude --limit 10
状态概览
cli-anything-ccswitch status
cli-anything-ccswitch
cli-anything-ccswitch --json

错误处理

当资源未找到时，CLI 会向 stderr 打印错误消息并以退出码 1 退出。Agent 应在解析输出前检查退出码。

数据库

CLI 从实时的 CC Switch SQLite 数据库读取。所有读取操作都是安全的，不会修改数据库。写入操作（providers set-current、proxy config、mcp enable、settings set）会直接修改数据库。

评论

支持 Markdown