From f7cc5969e3bf355307f616331f98c1307bb73ef0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=81=E4=B8=89=E5=88=86=E4=B9=8B=E4=BA=94=E5=85=AD?=
=?UTF-8?q?=E4=B8=83?= <16318297+xqwd528467@user.noreply.gitee.com>
Date: Tue, 1 Sep 2026 16:01:01 +0800
Subject: [PATCH] feat(mcp): add manual knowledge update tool
---
mcp-server/CHANGELOG.md | 3 +-
mcp-server/EXAMPLES.md | 17 +++++-
mcp-server/README.md | 3 +-
mcp-server/test_mcp_transports.py | 4 +-
mcp-server/test_update_knowledge_from_text.py | 58 +++++++++++++++++++
mcp-server/weknora_mcp_server.py | 39 +++++++++++++
6 files changed, 119 insertions(+), 5 deletions(-)
create mode 100644 mcp-server/test_update_knowledge_from_text.py
diff --git a/mcp-server/CHANGELOG.md b/mcp-server/CHANGELOG.md
index 4d8b161a..5a8e810a 100644
--- a/mcp-server/CHANGELOG.md
+++ b/mcp-server/CHANGELOG.md
@@ -9,6 +9,7 @@
### 新增
- 新增 `create_knowledge_from_text` 工具:通过手动 Markdown 文本创建知识条目,调用既有 `/knowledge-bases/{id}/knowledge/manual` 接口,补齐 #323 中"文本"部分。默认 `status="publish"`,创建后即进入解析/索引流程、可被检索;可传 `status="draft"` 仅保存不索引。
+- 新增 `update_knowledge_from_text` 工具:通过既有 `PUT /knowledge/manual/{id}` 接口更新手工 Markdown 知识;默认重新索引,也可保存为草稿,补齐 #2378。
- README 工具清单补列既有的 `create_knowledge_from_file`。
## [1.1.1] - 2026-07-30
@@ -148,4 +149,4 @@ WeKnora/mcp-server/
### 兼容性
- 支持 Windows、macOS、Linux
- 支持 Python 3.10-3.12
-- 兼容现代 Python 包管理工具
\ No newline at end of file
+- 兼容现代 Python 包管理工具
diff --git a/mcp-server/EXAMPLES.md b/mcp-server/EXAMPLES.md
index a5825175..cb97340e 100644
--- a/mcp-server/EXAMPLES.md
+++ b/mcp-server/EXAMPLES.md
@@ -135,6 +135,21 @@ echo "WEKNORA_API_KEY=your_api_key_here" >> .env
}
```
+#### 更新手工知识
+```json
+{
+ "tool": "update_knowledge_from_text",
+ "arguments": {
+ "knowledge_id": "know_789012",
+ "title": "注意力机制摘要(修订版)",
+ "content": "# 注意力机制\n\n这里是修订后的 Markdown 内容...",
+ "status": "publish"
+ }
+}
+```
+
+省略 `title` 或传空字符串会保留原标题;将 `status` 设为 `draft` 可只保存内容而不重新索引。
+
#### 列出知识
```json
{
@@ -421,4 +436,4 @@ python main.py --verbose
1. 运行 `python main.py --check-only` 检查环境
2. 使用 `python main.py --verbose` 查看详细日志
3. 检查 WeKnora 服务是否正常运行
-4. 验证网络连接和防火墙设置
\ No newline at end of file
+4. 验证网络连接和防火墙设置
diff --git a/mcp-server/README.md b/mcp-server/README.md
index 8468bc44..4ba38730 100644
--- a/mcp-server/README.md
+++ b/mcp-server/README.md
@@ -123,6 +123,7 @@ python test_module.py
- `create_knowledge_from_file` - 从本地文件创建知识
- `create_knowledge_from_url` - 从 URL 创建知识
- `create_knowledge_from_text` - 从文本创建知识
+- `update_knowledge_from_text` - 更新手工 Markdown 知识,可重新索引或保存为草稿
- `list_knowledge` - 列出知识
- `get_knowledge` - 获取知识详情
- `delete_knowledge` - 删除知识
@@ -154,4 +155,4 @@ python test_module.py
## 调用效果
-
\ No newline at end of file
+
diff --git a/mcp-server/test_mcp_transports.py b/mcp-server/test_mcp_transports.py
index 32b05ce1..808740a7 100644
--- a/mcp-server/test_mcp_transports.py
+++ b/mcp-server/test_mcp_transports.py
@@ -66,7 +66,7 @@ class TransportRegressionTest(unittest.TestCase):
class StdioToolsListTest(unittest.TestCase):
- def test_tools_list_returns_30_tools(self):
+ def test_tools_list_returns_31_tools(self):
async def _run() -> int:
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client
@@ -86,7 +86,7 @@ class StdioToolsListTest(unittest.TestCase):
return len(tools.tools)
count = asyncio.run(_run())
- self.assertEqual(count, 30)
+ self.assertEqual(count, 31)
class HttpStatelessSmokeTest(unittest.TestCase):
diff --git a/mcp-server/test_update_knowledge_from_text.py b/mcp-server/test_update_knowledge_from_text.py
new file mode 100644
index 00000000..94fba1fd
--- /dev/null
+++ b/mcp-server/test_update_knowledge_from_text.py
@@ -0,0 +1,58 @@
+#!/usr/bin/env python3
+"""Tests for the update_knowledge_from_text MCP tool and client method."""
+
+import unittest
+from unittest import mock
+
+import weknora_mcp_server as srv
+
+
+class UpdateKnowledgeFromTextTest(unittest.TestCase):
+ def test_client_puts_manual_update_to_expected_endpoint(self):
+ client = srv.WeKnoraClient("http://localhost:8080/api/v1", "k")
+ with mock.patch.object(client, "_request") as req:
+ req.return_value = {"ok": True}
+ result = client.update_knowledge_from_text(
+ "knowledge-1", "# Updated", title="New title"
+ )
+
+ self.assertEqual(result, {"ok": True})
+ req.assert_called_once_with(
+ "PUT",
+ "/knowledge/manual/knowledge-1",
+ json={
+ "title": "New title",
+ "content": "# Updated",
+ "status": "publish",
+ },
+ )
+
+ def test_client_can_save_a_draft_and_keep_the_title(self):
+ client = srv.WeKnoraClient("http://localhost:8080/api/v1", "k")
+ with mock.patch.object(client, "_request") as req:
+ req.return_value = {"ok": True}
+ client.update_knowledge_from_text(
+ "knowledge-1", "Draft content", status="draft"
+ )
+
+ self.assertEqual(
+ req.call_args.kwargs["json"],
+ {"title": "", "content": "Draft content", "status": "draft"},
+ )
+
+ def test_tool_forwards_all_update_fields(self):
+ with mock.patch.object(
+ srv.client, "update_knowledge_from_text", return_value={"ok": True}
+ ) as method:
+ result = srv.update_knowledge_from_text(
+ "knowledge-1", "Body", title="Title", status="draft"
+ )
+
+ self.assertEqual(result, {"ok": True})
+ method.assert_called_once_with(
+ "knowledge-1", "Body", title="Title", status="draft"
+ )
+
+
+if __name__ == "__main__":
+ unittest.main()
diff --git a/mcp-server/weknora_mcp_server.py b/mcp-server/weknora_mcp_server.py
index af158b94..33a9d947 100644
--- a/mcp-server/weknora_mcp_server.py
+++ b/mcp-server/weknora_mcp_server.py
@@ -360,6 +360,26 @@ class WeKnoraClient:
"POST", f"/knowledge-bases/{kb_id}/knowledge/manual", json=data
)
+ def update_knowledge_from_text(
+ self,
+ knowledge_id: str,
+ content: str,
+ title: str = "",
+ status: str = "publish",
+ ) -> Dict:
+ """Update an existing manual Markdown knowledge entry.
+
+ An empty ``title`` keeps the current title. ``status`` defaults to
+ ``"publish"`` so the updated content is re-indexed immediately; pass
+ ``"draft"`` to save it without indexing.
+ """
+ data = {
+ "title": title,
+ "content": content,
+ "status": status,
+ }
+ return self._request("PUT", f"/knowledge/manual/{knowledge_id}", json=data)
+
def list_knowledge(self, kb_id: str, page: int = 1, page_size: int = 20) -> Dict:
"""List knowledge in a knowledge base"""
params = {"page": page, "page_size": page_size}
@@ -760,6 +780,25 @@ def create_knowledge_from_text(
)
+@mcp.tool()
+def update_knowledge_from_text(
+ knowledge_id: str,
+ content: str,
+ title: str = "",
+ status: str = "publish",
+) -> dict:
+ """Update an existing manual Markdown knowledge entry.
+
+ ``knowledge_id`` is the ID returned by ``create_knowledge_from_text`` or
+ ``list_knowledge``. ``content`` is required. Leave ``title`` empty to keep
+ the current title. ``status`` defaults to ``"publish"`` so the new content
+ is re-indexed; pass ``"draft"`` to save without indexing.
+ """
+ return client.update_knowledge_from_text(
+ knowledge_id, content, title=title, status=status
+ )
+
+
@mcp.tool()
def list_knowledge(kb_id: str, page: int = 1, page_size: int = 20) -> dict:
"""List knowledge entries in a knowledge base."""