random-video-mcp 1.0.0

package/.env.example

@@ -0,0 +1,2 @@
+# 配置 webhook URL，所有调用信息都会 POST 到这个地址
+MCP_WEBHOOK_URL=https://your-api.com/webhook

package/README.md

@@ -0,0 +1,126 @@
+# Random Video MCP Server
+
+一个支持 webhook 日志记录的 MCP 服务器，用于生成随机视频。
+
+## 功能特性
+
+- 🎬 获取随机视频（支持多种类型：明星/热舞/风景/游戏/动物/动漫）
+- 📊 Webhook 日志记录 - 自动将所有调用信息 POST 到你配置的接口
+- 🚀 支持 npx 直接运行
+
+## 安装
+
+```bash
+npm install -g random-video-mcp
+```
+
+或使用 npx 直接运行（无需安装）：
+
+```bash
+npx random-video-mcp
+```
+
+## 配置 Webhook（可选）
+
+如果你想监控所有调用信息，可以通过环境变量 `MCP_WEBHOOK_URL` 配置你的 webhook 接口地址。每次工具被调用时，服务器会自动将以下信息 POST 到你的接口：
+
+### Webhook 数据格式
+
+```json
+{
+  "timestamp": "2026-02-04T10:00:00.000Z",
+  "server": "random-video-mcp",
+  "event": "tool_call",
+  "tool_name": "get_random_video",
+  "arguments": {
+    "msg": "动漫",
+    "type": "json"
+  },
+  "full_request": { ... },
+  "meta": { ... }
+}
+```
+
+### 在 Cursor 中配置
+
+在 Cursor 的 MCP 设置中添加：
+
+```json
+{
+  "mcpServers": {
+    "random-video": {
+      "command": "npx",
+      "args": ["-y", "random-video-mcp"],
+      "env": {
+        "MCP_WEBHOOK_URL": "https://your-webhook-url.com/api/log"
+      }
+    }
+  }
+}
+```
+
+### 使用本地路径
+
+```json
+{
+  "mcpServers": {
+    "random-video": {
+      "command": "node",
+      "args": ["/path/to/random-video-mcp/index.js"],
+      "env": {
+        "MCP_WEBHOOK_URL": "https://your-webhook-url.com/api/log"
+      }
+    }
+  }
+}
+```
+
+## 工具说明
+
+### get_random_video
+
+获取随机视频。
+
+**参数：**
+- `msg` (可选): 视频类型
+  - 可选值：`明星` | `热舞` | `风景` | `游戏` | `动物` | `动漫`
+  - 默认值：`动漫`
+- `type` (可选): 输出格式
+  - 可选值：`json` | `text`
+  - 默认值：`json`
+
+**返回示例（JSON）：**
+```json
+{
+  "code": 1,
+  "text": "获取成功",
+  "data": {
+    "img": "http://cdn.video.picasso.dandanjiang.tv/xxx.jpg",
+    "mold": "#标签1 #标签2",
+    "url": "http://cdn.video.picasso.dandanjiang.tv/xxx.mp4"
+  }
+}
+```
+
+## 发布到 NPM
+
+```bash
+# 1. 登录 npm
+npm login
+
+# 2. 发布
+npm publish
+```
+
+## Webhook 事件类型
+
+服务器会发送以下类型的事件：
+
+1. **server_start** - 服务器启动
+2. **tool_call** - 工具被调用
+3. **tool_result** - 工具执行成功
+4. **tool_error** - 工具执行失败
+
+## 许可证
+
+MIT

package/example-config.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "random-video": {
+      "command": "npx",
+      "args": ["-y", "random-video-mcp"],
+      "env": {
+        "MCP_WEBHOOK_URL": "https://your-api.com/webhook"
+      }
+    }
+  }
+}

package/index.js

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+// 从环境变量读取 webhook URL
+const WEBHOOK_URL = process.env.MCP_WEBHOOK_URL;
+
+// 发送日志到 webhook
+async function sendLog(data) {
+  if (!WEBHOOK_URL) {
+    return; // 如果没有配置 webhook，就不发送
+  }
+
+  try {
+    await fetch(WEBHOOK_URL, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({
+        timestamp: new Date().toISOString(),
+        server: "random-video-mcp",
+        ...data,
+      }),
+    });
+  } catch (error) {
+    // 静默失败，不影响主功能
+    console.error("Failed to send log to webhook:", error.message);
+  }
+}
+
+// 创建MCP服务器实例
+const server = new Server(
+  {
+    name: "random-video-mcp",
+    version: "1.0.0",
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+// 生成随机视频的函数
+async function getRandomVideo(msg = "动漫", type = "json") {
+  const url = new URL("http://api.4qb.cn/api/suiji-sp");
+  url.searchParams.append("msg", msg);
+  url.searchParams.append("type", type);
+
+  try {
+    const response = await fetch(url.toString());
+    
+    if (type === "json") {
+      const data = await response.json();
+      return data;
+    } else {
+      const text = await response.text();
+      return text;
+    }
+  } catch (error) {
+    throw new Error(`Failed to fetch random video: ${error.message}`);
+  }
+}
+
+// 注册工具列表处理器
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      {
+        name: "get_random_video",
+        description: "获取随机视频。可以指定视频类型（明星/热舞/风景/游戏/动物/动漫）和输出格式（json/text）",
+        inputSchema: {
+          type: "object",
+          properties: {
+            msg: {
+              type: "string",
+              description: "视频类型：明星/热舞/风景/游戏/动物/动漫",
+              enum: ["明星", "热舞", "风景", "游戏", "动物", "动漫"],
+              default: "动漫",
+            },
+            type: {
+              type: "string",
+              description: "输出格式：json或text",
+              enum: ["json", "text"],
+              default: "json",
+            },
+          },
+        },
+      },
+    ],
+  };
+});
+
+// 注册工具调用处理器
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  // 记录所有调用信息
+  const logData = {
+    event: "tool_call",
+    tool_name: request.params.name,
+    arguments: request.params.arguments,
+    full_request: request.params,
+    meta: request.meta || {},
+  };
+
+  // 发送日志到 webhook（不等待，异步发送）
+  sendLog(logData).catch(() => {});
+
+  if (request.params.name === "get_random_video") {
+    const msg = request.params.arguments?.msg || "动漫";
+    const type = request.params.arguments?.type || "json";
+
+    try {
+      const result = await getRandomVideo(msg, type);
+      
+      // 记录成功结果
+      sendLog({
+        event: "tool_result",
+        tool_name: request.params.name,
+        arguments: request.params.arguments,
+        success: true,
+        result_preview: typeof result === "string" ? result.substring(0, 200) : JSON.stringify(result).substring(0, 200),
+      }).catch(() => {});
+      
+      return {
+        content: [
+          {
+            type: "text",
+            text: typeof result === "string" ? result : JSON.stringify(result, null, 2),
+          },
+        ],
+      };
+    } catch (error) {
+      // 记录错误
+      sendLog({
+        event: "tool_error",
+        tool_name: request.params.name,
+        arguments: request.params.arguments,
+        error: error.message,
+      }).catch(() => {});
+      
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Error: ${error.message}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+  }
+
+  throw new Error(`Unknown tool: ${request.params.name}`);
+});
+
+// 启动服务器
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  
+  const webhookStatus = WEBHOOK_URL ? `with webhook: ${WEBHOOK_URL}` : "without webhook";
+  console.error(`Random Video MCP Server running on stdio ${webhookStatus}`);
+  
+  // 记录服务器启动
+  if (WEBHOOK_URL) {
+    sendLog({
+      event: "server_start",
+      env: {
+        NODE_VERSION: process.version,
+        PLATFORM: process.platform,
+        ARCH: process.arch,
+      },
+    }).catch(() => {});
+  }
+}
+
+main().catch((error) => {
+  console.error("Server error:", error);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "random-video-mcp",
+  "version": "1.0.0",
+  "description": "MCP server学习，日志打点",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "random-video-mcp": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "video",
+    "random",
+    "webhook"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yourusername/random-video-mcp.git"
+  },
+  "files": [
+    "index.js",
+    "example-config.json",
+    ".env.example"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3"
+  }
+}