dingtalk-dws-mcp 1.0.1 → 1.0.2

package/README.md

@@ -2,7 +2,7 @@
 
 源码包。用户能力与接入见 [`mcp/dingtalk-dws-mcp/GUIDE.md`](../../../mcp/dingtalk-dws-mcp/GUIDE.md)。
 
-Agent：`instructions` / tool `description` / `prompts`。长期巡检：`dingtalk_patrol_setup` 备料 → 传装到主机 → 停。
+Agent：`instructions` / tool `description` / `prompts` / **Resources（`guides/*.md`）**。长期巡检：`dingtalk_patrol_setup` 备料 → 传装到主机 → 停。
 
 ## 构建
 
@@ -16,6 +16,6 @@ npm run pack:deploy
 可选：`DINGTALK_PATROL_INCLUDE_NODE=0`、`DINGTALK_PATROL_NODE_URL`、`DINGTALK_PATROL_INCLUDE_DWS=0`（默认尝试打入 linux ELF dws；Windows 打包机需 `DINGTALK_PATROL_DWS_PATH` 指向 ELF）。  
 `dingtalk_patrol_setup` 只写 staging（含本机已验证投递凭据）；传装用 host-execution 或 SSH，目标机跑 `install.sh`。可选 `deploy.sh` 为直连 SSH helper。  
 
-配置示例（npx）：[`mcp/dingtalk-dws-mcp/mcp.example.json`](../../../mcp/dingtalk-dws-mcp/mcp.example.json)。npm：`dingtalk-dws-mcp@1.0.0`。
+配置示例（npx）：[`mcp/dingtalk-dws-mcp/mcp.example.json`](../../../mcp/dingtalk-dws-mcp/mcp.example.json)。npm：`dingtalk-dws-mcp@1.0.2`。
 
 规格（开发者）：[RFC-0007](../../../docs/rfc/RFC-0007-dingtalk-dws-mcp.md)、[RFC-0008](../../../docs/rfc/RFC-0008-dingtalk-notify-patrol.md)。

package/dist/src/resources/guides.d.ts

@@ -0,0 +1,24 @@
+export type GuideMeta = {
+    slug: string;
+    uri: string;
+    title: string;
+    description: string;
+};
+export declare function listMcpGuideResources(): Array<{
+    uri: string;
+    name: string;
+    title: string;
+    description: string;
+    mimeType: string;
+    annotations: {
+        audience: Array<"user" | "assistant">;
+        priority: number;
+    };
+}>;
+export declare function readMcpGuideResource(uri: string): {
+    contents: Array<{
+        uri: string;
+        mimeType: string;
+        text: string;
+    }>;
+};

package/dist/src/resources/guides.js

@@ -0,0 +1,36 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { mcpPackageRoot } from "../version.js";
+const GUIDES = [
+    {
+        slug: "doc-search",
+        uri: "dingtalk-dws://guides/doc-search",
+        title: "DingTalk cloud doc search",
+        description: "Agent overlay: drive search short path and stop-rules; prefer over upstream doc search recipes when they lag.",
+    },
+];
+function readMarkdown(slug) {
+    const filePath = path.join(mcpPackageRoot(), "guides", `${slug}.md`);
+    return fs.readFileSync(filePath, "utf8");
+}
+export function listMcpGuideResources() {
+    return GUIDES.map((g) => ({
+        uri: g.uri,
+        name: g.slug,
+        title: g.title,
+        description: g.description,
+        mimeType: "text/markdown",
+        annotations: { audience: ["assistant"], priority: 0.7 },
+    }));
+}
+export function readMcpGuideResource(uri) {
+    const guide = GUIDES.find((g) => g.uri === uri);
+    if (!guide) {
+        const err = new Error(`Resource not found: ${uri}`);
+        err.code = -32002;
+        throw err;
+    }
+    return {
+        contents: [{ uri, mimeType: "text/markdown", text: readMarkdown(guide.slug) }],
+    };
+}

package/dist/src/server.js

@@ -1,9 +1,10 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { loadConfig } from "./config.js";
 import { IdempotencyStore } from "./notify/idempotency-store.js";
 import { getPromptMessages, listPromptDefinitions } from "./prompts.js";
+import { listMcpGuideResources, readMcpGuideResource } from "./resources/guides.js";
 import { DingtalkDwsService } from "./service.js";
 import { buildInstructions, callTool, createToolDefinitions, resolveToolSurface } from "./tools/registry.js";
 import { readPackageVersion } from "./version.js";
@@ -22,7 +23,7 @@ export function createMcpServer(service, store) {
     if (!resolvedStore)
         throw new Error("store required");
     const surface = resolveToolSurface(adapter);
-    const server = new Server({ name: MCP_SERVER_NAME, version: MCP_SERVER_VERSION }, { capabilities: { tools: {}, prompts: {} }, instructions: buildInstructions(surface) });
+    const server = new Server({ name: MCP_SERVER_NAME, version: MCP_SERVER_VERSION }, { capabilities: { tools: {}, prompts: {}, resources: {} }, instructions: buildInstructions(surface) });
     const tools = createToolDefinitions(surface);
     server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [...tools] }));
     server.setRequestHandler(CallToolRequestSchema, async (request) => (callTool(resolvedService, request.params.name, request.params.arguments ?? {}, surface)));
@@ -37,6 +38,10 @@ export function createMcpServer(service, store) {
             throw new Error(`Unknown prompt: ${request.params.name}`);
         }
     });
+    server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+        resources: listMcpGuideResources(),
+    }));
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => (readMcpGuideResource(request.params.uri)));
     return { server, service: resolvedService, store: resolvedStore };
 }
 export async function runStdioServer() {

package/dist/src/tools/registry.js

@@ -15,6 +15,7 @@ export function buildInstructions(surface) {
     // User-selected recipes → prompts. Do not duplicate those here.
     const lines = [
         "DingTalk robot notify + dws readiness (Agent surface of the dws ecosystem). Office stays on local dws.",
+        "Office via local dws: before following upstream Skill recipes, read this server's MCP Resources overlays when they apply.",
         "Constraint: recurring/host patrol must not use session loops or repeated dingtalk_send — Agent derives host/cron/probe from conversation, calls dingtalk_patrol_setup once (stages bundle paths + delivery credentials), copies to host via host-execution or SSH, runs install.sh on the host, then stops. MCP env holds credentials only. Do not download Node in-session.",
         "Call dingtalk_doctor first; connected ≠ ready.",
     ];

package/guides/doc-search.md

@@ -0,0 +1,37 @@
+# DingTalk cloud doc search (Agent overlay)
+
+Use this when the user asks to find / list / summarize DingTalk cloud docs or knowledge-base pages.
+
+Upstream dws Skill recipes may still say `doc search` / `doc list`. Prefer this overlay when they conflict.
+
+## Short path
+
+1. One primary search:
+   ```bash
+   dws drive search --query "<user keywords>" --format json
+   ```
+2. From `documents[]`, keep **5–10** hits with `name` / `nodeId` / `docUrl` (or `url`) / type.
+3. Deliver a **table** (name + link + one-line why relevant). Stop here if that answers the user.
+4. Only if the user wants depth, or top hits need a title skim: read **at most 2–3** `adoc` nodes:
+   ```bash
+   dws doc read --node <nodeId> --content-format markdown --format json
+   ```
+   Use the JSON field **`markdown`** (not `content`). Prefer headings / first ~20 lines — not the whole body in chat.
+
+## Do not
+
+- Recurse `drive list` / wiki folder listing after search (folder child names are often opaque IDs).
+- Fire many overlapping queries (`性能优化` + `训练性能` + …) by default — one main query, optional one supplement.
+- Pull full document bodies by default.
+- Treat dlink / non-adoc hits as readable via `doc read` — give the link only.
+- Treat empty `doc read` as “try another format / write a helper script” — check the `markdown` field / `--help` once, then skip or try the next hit.
+
+## Knowledge-base scoped search
+
+If the user already named a workspace/knowledge base:
+
+```bash
+dws wiki node search --workspace <id> --query "<keywords>" --format json
+```
+
+Otherwise stay on global `drive search`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dingtalk-dws-mcp",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "DingTalk robot notification MCP with dws readiness handshake",
   "license": "Apache-2.0",
   "type": "module",
@@ -10,6 +10,7 @@
   "main": "dist/src/index.js",
   "files": [
     "dist/src",
+    "guides",
     "README.md",
     "LICENSE"
   ],