ym-openclaw-task 1.0.0

package/README.md

@@ -0,0 +1,66 @@
+# ym-openclaw-task
+
+OpenClaw（龙虾）任务完成上报 MCP server。任务结束后自动将 **执行时间（精确到年月日时分秒）** 与 **完成概要** 上报到你指定的接口。
+
+## 安装与运行
+
+```bash
+npm install
+npm start        # 以 MCP server（stdio）方式启动
+```
+
+## 工具
+
+| 工具 | 参数 | 说明 |
+| --- | --- | --- |
+| `report_task` | `task_name`(必填) | 上报任务完成：raw JSON POST 到 REPORT_URL |
+
+上报的 JSON 格式（**固定模板，三个字段**）：
+
+```json
+{
+  "title": "下发给龙虾工作任务",
+  "content": "下发龙虾的任务：任务名已完成请前往查阅结果",
+  "datetime": "2026-09-13 06:12:38"
+}
+```
+
+- `title`：固定「下发给龙虾工作任务」
+- `content`：固定模板「下发龙虾的任务：{任务名}已完成请前往查阅结果」
+- `datetime`：完成后 +10 秒，精确到年月日时分秒
+
+## 配置（环境变量）
+
+| 变量 | 必填 | 说明 |
+| --- | --- | --- |
+| `REPORT_URL` | 是 | 上报接口地址（POST） |
+| `REPORT_HEADERS` | 否 | JSON 字符串，附加请求头 |
+
+## 注册到 OpenClaw
+
+发布到 npm 后：
+
+```bash
+openclaw mcp add ym-openclaw-task \
+  --command npx --args -y ym-openclaw-task \
+  --env REPORT_URL=http://你的接口/report
+openclaw daemon restart
+```
+
+OpenClaw 即可在任务结束时调用 `report_task` 工具完成上报。
+
+## 接入 MCP 客户端（通用配置）
+
+```json
+{
+  "mcpServers": {
+    "ym-openclaw-task": {
+      "command": "npx",
+      "args": ["-y", "ym-openclaw-task"],
+      "env": {
+        "REPORT_URL": "http://你的接口/report"
+      }
+    }
+  }
+}
+```

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "ym-openclaw-task",
+  "version": "1.0.0",
+  "description": "OpenClaw（龙虾）任务完成上报 MCP server：任务结束后自动将执行时间（精确到年月日时分秒）与完成概要上报到指定接口。",
+  "type": "module",
+  "main": "./src/index.js",
+  "bin": {
+    "ym-openclaw-task": "src/index.js"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node src/index.js",
+    "test": "node test/report.test.mjs"
+  },
+  "keywords": [
+    "openclaw",
+    "mcp",
+    "report",
+    "task",
+    "webhook",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  }
+}

package/src/index.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+/**
+ * ym-openclaw-task — OpenClaw（龙虾）任务完成上报 MCP server（stdio）
+ *
+ * 工具 report_task：
+ *   OpenClaw（或任何 MCP 客户端）在任务结束时调用它，把「执行时间（精确到年月日时分秒）
+ *   + 完成概要」POST 到配置的 REPORT_URL。
+ *
+ * 注册到 OpenClaw（发布到 npm 后）：
+ *   openclaw mcp add ym-openclaw-task --command npx --args -y ym-openclaw-task \
+ *     --env REPORT_URL=http://your-server/report
+ *
+ * 环境变量：
+ *   REPORT_URL        必填，上报接口地址（POST）
+ *   REPORT_HEADERS    可选，JSON 对象字符串，附加请求头（如 {"Authorization":"Bearer xxx"}）
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import {
+  ListToolsRequestSchema,
+  CallToolRequestSchema,
+} from '@modelcontextprotocol/sdk/types.js';
+
+/** 当前时间，格式 YYYY-MM-DD HH:mm:ss（本地时区，精确到秒） */
+export function nowString(date = new Date()) {
+  const p = (n) => String(n).padStart(2, '0');
+  return `${date.getFullYear()}-${p(date.getMonth() + 1)}-${p(date.getDate())} ${p(date.getHours())}:${p(date.getMinutes())}:${p(date.getSeconds())}`;
+}
+
+/** 上报时间相对当前延后 10 秒（接口约定：完成后增加 10 秒） */
+export const REPORT_DELAY_MS = 10000;
+
+function loadEnv() {
+  const url = process.env.REPORT_URL || '';
+  let headers = {};
+  if (process.env.REPORT_HEADERS) {
+    try {
+      headers = JSON.parse(process.env.REPORT_HEADERS);
+    } catch {
+      process.stderr.write('[ym-openclaw-task] 警告: REPORT_HEADERS 不是合法 JSON，已忽略\n');
+    }
+  }
+  return { url, headers: { 'Content-Type': 'application/json', ...headers } };
+}
+
+/** 上报到指定接口，返回 { ok, status, responseText } */
+export async function report(payload) {
+  const { url, headers } = loadEnv();
+  if (!url) {
+    throw new Error('未配置 REPORT_URL，无法上报。请在环境变量中设置 REPORT_URL。');
+  }
+  const resp = await fetch(url, {
+    method: 'POST',
+    headers,
+    body: JSON.stringify(payload),
+  });
+  const text = await resp.text();
+  if (!resp.ok) {
+    throw new Error(`上报失败 HTTP ${resp.status}: ${text.slice(0, 300)}`);
+  }
+  return { ok: true, status: resp.status, responseText: text };
+}
+
+/** 固定标题 */
+export const REPORT_TITLE = '下发给龙虾工作任务';
+
+/** 组装上报体（raw JSON）：title 固定 / content 固定模板含任务名 / datetime 完成后+10秒 */
+export function buildReportPayload(taskName, now = new Date()) {
+  return {
+    title: REPORT_TITLE,
+    content: `下发龙虾的任务：${String(taskName ?? '')}已完成请前往查阅结果`,
+    datetime: nowString(new Date(now.getTime() + REPORT_DELAY_MS)),
+  };
+}
+
+const server = new Server(
+  { name: 'ym-openclaw-task', version: '1.0.0' },
+  { capabilities: { tools: {} } }
+);
+
+const TOOLS = [
+  {
+    name: 'report_task',
+    description:
+      '上报 OpenClaw（龙虾）任务完成：title 固定「下发给龙虾工作任务」，content 固定模板「下发龙虾的任务：{任务名}已完成请前往查阅结果」，datetime 完成后+10秒（YYYY-MM-DD HH:mm:ss），raw JSON POST 到配置的 REPORT_URL。任务结束时调用。',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        task_name: {
+          type: 'string',
+          description: '任务名称（会拼进 content 模板）',
+        },
+      },
+      required: ['task_name'],
+    },
+  },
+];
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+  if (name !== 'report_task') {
+    throw new Error(`Unknown tool: ${name}`);
+  }
+  const taskName = String(args.task_name ?? '');
+  if (!taskName) {
+    throw new Error('缺少参数：report_task 需要 task_name');
+  }
+
+  const payload = buildReportPayload(taskName);
+
+  let result;
+  try {
+    result = await report(payload);
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `上报成功：任务「${taskName}」已完成并上报，datetime ${payload.datetime}。\n响应: HTTP ${result.status} ${result.responseText}`,
+        },
+      ],
+    };
+  } catch (err) {
+    return {
+      isError: true,
+      content: [{ type: 'text', text: `上报失败：${err.message}` }],
+    };
+  }
+});
+
+const transport = new StdioServerTransport();
+await server.connect(transport);