codexmate 0.0.12 → 0.0.13

package/README.md

@@ -33,7 +33,7 @@ One tool to switch Codex/Claude Code providers & models and manage/browse local
 - Lightweight Web UI instead of heavy clients
 - Unified session browser (view/export/resume when available)
 - Session management: list/filter/export/delete local sessions; keyword search supports Codex and Claude
-- New in 0.0.9: Claude sessions are searchable by keywords (e.g., `claude code`, `claude-code`, numeric tokens)
+- New in 0.0.10: Claude sessions are searchable by keywords (e.g., `claude code`, `claude-code`, numeric tokens)
 
 ## Feature Overview
 
@@ -169,8 +169,30 @@ npm link
 | `codexmate add-model <model>` | Add a model |
 | `codexmate delete-model <model>` | Delete a model |
 | `codexmate run` | Start the Web UI |
+| `codexmate mcp [serve] [--transport stdio] [--allow-write\|--read-only]` | Start MCP server over stdio (default read-only) |
 | `codexmate export-session --source <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--max-messages <N|all|Infinity>]` | Export a session to Markdown |
 
+## MCP (stdio)
+
+- Transport: `stdio` only
+- Default mode: read-only tool set
+- Write tools: enable by `--allow-write` or `CODEXMATE_MCP_ALLOW_WRITE=1`
+- Sensitive fields in `codexmate.claude.settings.get` are returned as masked values
+
+```bash
+# Read-only (recommended for external agents)
+codexmate mcp serve --read-only
+
+# Enable write tools explicitly
+codexmate mcp serve --allow-write
+```
+
+Provided MCP domains:
+
+- `tools`: status/provider/model/session/auth/proxy and config operations
+- `resources`: status/providers/sessions snapshots
+- `prompts`: built-in diagnose/switch/export templates
+
 ## Web UI
 
 Start the Web UI (auto opens browser):
@@ -371,7 +393,7 @@ Note: 7-Zip is optional. If missing, the built-in JS library is used. `--max` on
 
 ## Release (GitHub Actions)
 
-Create a tag that matches `package.json` (for example `v0.0.8`). Then run the `release` workflow in GitHub Actions and input that tag. It will create a GitHub Release and attach the `npm pack` `.tgz` artifact.
+Create a tag that matches `package.json` (for example `v0.0.9`). Then run the `release` workflow in GitHub Actions and input that tag. It will create a GitHub Release and attach the `npm pack` `.tgz` artifact.
 
 ## License
 

package/README.zh-CN.md

@@ -33,7 +33,7 @@ Codex Mate 让 Codex 与 Claude Code 的提供商/模型切换变成“一条命
 - 可视化 Web 操作，降低命令行负担
 - 配置变更可回溯、有备份
 - Codex + Claude Code 统一会话浏览（查看/导出/可用时复制恢复命令）
- - 0.0.9 新增：Claude 会话支持关键词搜索（含 `claude code` / `claude-code` / 数字关键词）
+ - 0.0.10 新增：Claude 会话支持关键词搜索（含 `claude code` / `claude-code` / 数字关键词）
 
 ## 概览
 
@@ -175,8 +175,30 @@ npm link
 | `codexmate add-model <模型名称>` | 添加模型 |
 | `codexmate delete-model <模型名称>` | 删除模型 |
 | `codexmate run` | 启动 Web 界面 |
+| `codexmate mcp [serve] [--transport stdio] [--allow-write\|--read-only]` | 启动 MCP stdio 服务（默认只读） |
 | `codexmate export-session --source <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--max-messages <N|all|Infinity>]` | 导出指定会话为 Markdown |
 
+## MCP（stdio）
+
+- 传输方式：仅支持 `stdio`
+- 默认模式：只读工具集
+- 写入工具开启方式：`--allow-write` 或 `CODEXMATE_MCP_ALLOW_WRITE=1`
+- `codexmate.claude.settings.get` 的敏感字段默认脱敏返回
+
+```bash
+# 只读（推荐给外部 Agent 接入）
+codexmate mcp serve --read-only
+
+# 显式开启写工具
+codexmate mcp serve --allow-write
+```
+
+当前提供的 MCP 能力：
+
+- `tools`：状态/提供商/模型/会话/认证/代理/配置等操作
+- `resources`：status/providers/sessions 快照资源
+- `prompts`：诊断/安全切换/会话导出模板
+
 ## Web 界面
 
 启动 Web 界面（自动打开浏览器）：
@@ -377,7 +399,7 @@ codexmate unzip ./backup.zip D:/restored
 
 ## 发布（GitHub Actions）
 
-创建与 `package.json` 版本一致的标签（例如 `v0.0.8`）。然后在 GitHub Actions 中手动运行 `release` 工作流并输入该标签，系统会创建 GitHub Release，并附带 `npm pack` 生成的 `.tgz` 产物。
+创建与 `package.json` 版本一致的标签（例如 `v0.0.9`）。然后在 GitHub Actions 中手动运行 `release` 工作流并输入该标签，系统会创建 GitHub Release，并附带 `npm pack` 生成的 `.tgz` 产物。
 
 ## 许可证