Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Python agent-contextagent-memoryagent-pluginsagentic-ragcontext-databasedsh-pluginknowledge-basememorymemory-managementself-evolvingvector-database
docs(mcp): document list_watches and cancel_watch in MCP integration table (#2110) (#2134)
Evoc11e19fdcd4f
diff --git a/docs/en/guides/06-mcp-integration.md b/docs/en/guides/06-mcp-integration.mdindex b62219735..8e8c81edb 100644--- a/docs/en/guides/06-mcp-integration.md+++ b/docs/en/guides/06-mcp-integration.md@@ -103,7 +103,7 @@ no external proxy is needed.## Available MCP Tools-Once connected, OpenViking exposes 9 tools:+Once connected, OpenViking exposes 11 tools:| Tool | Description | Key Parameters ||------|-------------|----------------|@@ -112,11 +112,15 @@ Once connected, OpenViking exposes 9 tools:| `list` | List entries under a `viking://` directory | `uri`, `recursive` (optional) || `store` | Store messages into long-term memory (triggers extraction) | `messages` (list of `{role, content}`) || `add_resource` | Add a local file or URL as a resource (local files trigger a progressive upload flow) | `path`, `temp_file_id` (optional), `description` (optional), `watch_interval` (optional, minutes — auto-refresh cadence for remote URLs), `to` (optional, target `viking://resources/...` URI; required when `watch_interval > 0`) |+| `list_watches` | List watch tasks (auto-refresh subscriptions) visible to the current agent. Each entry shows target URI, refresh interval (minutes), active/paused status, and next scheduled execution time | none |+| `cancel_watch` | Cancel (delete) a watch task by its target URI. To change the cadence or pause temporarily, cancel and re-add with a new `watch_interval` | `to_uri` (must match the watch task's `to` value, e.g. `viking://resources/...`) || `grep` | Regex content search across `viking://` files | `uri`, `pattern` (string or array), `case_insensitive` || `glob` | Find files matching a glob pattern | `pattern`, `uri` (optional scope) || `forget` | Delete any `viking://` URI (use `search` to find it first; pass `recursive=true` to delete a directory) | `uri`, `recursive` (optional) || `health` | Check OpenViking service health | none |+> **Note**: MCP exposes the minimum closure for watch management (`list_watches` + `cancel_watch`). Pause / resume / trigger and the unified `update` verb are intentionally not exposed here — use the REST `/api/v1/watches/*` endpoints or the `ov task watch` CLI for those operations.+### Adding local-file resources (progressive upload)The `add_resource` tool accepts both **remote URLs** and **local file paths**, handled differently:diff --git a/docs/zh/guides/06-mcp-integration.md b/docs/zh/guides/06-mcp-integration.mdindex b1d16e098..d062872cc 100644--- a/docs/zh/guides/06-mcp-integration.md+++ b/docs/zh/guides/06-mcp-integration.md@@ -95,7 +95,7 @@ claude mcp add --transport http openviking \## 可用的 MCP 工具-连接后,OpenViking MCP 端点暴露 9 个工具:+连接后,OpenViking MCP 端点暴露 11 个工具:| 工具 | 说明 | 主要参数 ||------|------|----------|@@ -104,11 +104,15 @@ claude mcp add --transport http openviking \| `list` | 列出 `viking://` 目录下的条目 | `uri`, `recursive`(可选) || `store` | 存储消息到长期记忆(触发记忆提取) | `messages`(`{role, content}` 列表) || `add_resource` | 添加本地文件或 URL 作为资源(本地文件触发渐进式上传流) | `path`, `temp_file_id`(可选), `description`(可选), `watch_interval`(可选,分钟数 — 远程 URL 的自动刷新周期), `to`(可选,目标 `viking://resources/...` URI;`watch_interval > 0` 时必填) |+| `list_watches` | 列出当前 Agent 可见的 watch 任务(自动刷新订阅),每行显示目标 URI、刷新间隔(分钟)、active/paused 状态以及下一次调度时间 | 无 |+| `cancel_watch` | 按目标 URI 取消(删除)watch 任务。若需调整刷新周期或临时暂停,请取消后使用新的 `watch_interval` 重新添加 | `to_uri`(必须匹配 watch 任务的 `to` 值,例如 `viking://resources/...`) || `grep` | 在 `viking://` 文件中进行正则内容搜索 | `uri`, `pattern`(字符串或数组), `case_insensitive` || `glob` | 按 glob 模式匹配文件 | `pattern`, `uri`(可选范围) || `forget` | 删除任意 `viking://` URI(先用 `search` 查找;删除目录需 `recursive=true`) | `uri`, `recursive`(可选) || `health` | 检查 OpenViking 服务健康状态 | 无 |+> **注**:MCP 仅暴露 watch 管理的最小闭包(`list_watches` + `cancel_watch`)。pause / resume / trigger 和统一的 `update` 动作刻意不在此处暴露,请通过 REST `/api/v1/watches/*` 接口或 `ov task watch` CLI 使用上述操作。+### 添加本地文件资源(渐进式上传)`add_resource` 工具同时接受**远程 URL** 和**本地文件路径**。两者的处理路径不同: