@lionad/kimi-search 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.0.1] - 2026-03-10
+
+### Added
+- 初始版本发布
+- 实现 `kimi-search` MCP 工具，支持将 kimi 作为智能代理执行复杂搜索和分析任务
+- 支持通过 npx 直接运行：`npx -y @lionad/kimi-search`
+

package/README.md

@@ -0,0 +1,20 @@
+# Kimi Search MCP Server
+
+MCP 服务器，借助 kimi-cli 的力量实现网络搜索功能。
+
+## config
+
+```json
+{
+  "mcpServers": {
+    "kimi-search": {
+      "command": "npx",
+      "args": ["-y", "@lionad/kimi-search"]
+    }
+  }
+}
+```
+
+## tools
+
+* **kimi-search**: 将 kimi 作为智能代理执行复杂的搜索和分析任务（是 `kimi -p "搜索网络: xxx"` 的一层包装）

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * kimi-search MCP Server
+ *
+ * 此服务器将 kimi 作为智能代理(agent)暴露给 MCP 客户端，
+ * 支持执行复杂的搜索、分析和信息整合任务。
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+/**
+ * kimi-search MCP Server
+ *
+ * 此服务器将 kimi 作为智能代理(agent)暴露给 MCP 客户端，
+ * 支持执行复杂的搜索、分析和信息整合任务。
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { execFile } from "child_process";
+import { promisify } from "util";
+const execFileAsync = promisify(execFile);
+// Zod 模式用于输入验证
+const AgentInstructionSchema = z.object({
+    instruction: z.string()
+        .min(1, "指令不能为空")
+        .max(5000, "指令不能超过 5000 个字符")
+        .describe(`完整的任务指令，描述需要 kimi-search 执行的搜索或分析任务。
+
+指令应包含：
+1. 搜索关键词或搜索主题
+2. 具体目标（要获取什么信息）
+3. 执行步骤（如何获取和处理信息）
+4. 输出格式要求
+
+示例指令：
+---
+搜索："bun package manager vs pnpm benchmark 2025"
+
+目标：了解 Bun 作为新兴 JavaScript 包管理器与 pnpm 的对比，包括性能基准测试和功能差异
+
+使用 WebSearch 工具执行网络搜索。
+对于每个相关结果：
+1. 使用 WebFetch 或浏览器工具获取页面内容
+2. 提取与搜索目标相关的关键发现
+3. 记录：URL、标题、要点、相关度评分（1-5）
+
+以以下格式返回结构化结果：
+\`\`\`
+## {query}
+
+### 结果 1：{title}
+- URL: {url}
+- 相关度：{1-5}/5
+- 关键发现：
+  - {要点}
+- 引用：
+  - "{相关摘录}"
+\`\`\`
+
+关注事实信息和有数据支持的论断。
+---`)
+}).strict();
+// 执行 kimi-search 任务
+async function executeKimiAgent(_instruction) {
+    const instruction = `## Context\n* use 90 seconds timeout for tools\n\n以下是具体的网络搜索或分析任务\n\n---\n\n${_instruction}`;
+    try {
+        const { stdout } = await execFileAsync("kimi", [
+            "-p",
+            instruction,
+            "--print",
+            "--output-format",
+            "stream-json",
+            "--final-message-only"
+        ], {
+            timeout: 180000, // 3 分钟超时，给 agent 足够时间完成复杂任务
+            maxBuffer: 10 * 1024 * 1024 // 10MB 缓冲区
+        });
+        return stdout.trim();
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            if (error.message.includes("ENOENT")) {
+                throw new Error("未找到 kimi 命令。请确保 kimi CLI 已安装并添加到 PATH 中。");
+            }
+            if (error.message.includes("ETIMEDOUT")) {
+                throw new Error("任务执行超时。kimi-search 可能需要更长时间处理复杂任务，请稍后重试或简化任务。");
+            }
+            throw new Error(`任务执行失败: ${error.message}`);
+        }
+        throw error;
+    }
+}
+// 创建 MCP 服务器实例
+const server = new McpServer({
+    name: "kimi-search-mcp-server",
+    version: "0.0.1"
+});
+// 注册 kimi-search 工具
+server.registerTool("kimi-search", {
+    title: "kimi-search",
+    description: `将 kimi 作为智能代理(agent)执行复杂的搜索和分析任务。
+
+与简单的搜索工具不同，kimi-search 可以：
+- 进行多步骤的网络搜索
+- 分析和比较多个信息源
+- 生成结构化的报告和总结
+- 执行需要推理的复杂查询
+
+参数：
+  - instruction (string): 完整的任务指令，包含搜索关键词、目标、执行步骤和输出格式要求
+
+返回值：
+  kimi-search 完成任务的完整输出，通常包含搜索结果、分析或总结。
+
+使用场景对比：
+  ❌ 不适合：简单的关键词查询（如 "React"）
+  ✅ 适合：结构化的任务指令（包含目标、步骤、格式要求）
+
+示例指令结构：
+---
+搜索："bun package manager vs pnpm benchmark 2025"
+
+目标：了解 Bun 作为新兴 JavaScript 包管理器与 pnpm 的对比
+
+执行步骤：
+1. 使用 WebSearch 工具执行网络搜索
+2. 对于每个相关结果，获取页面内容
+3. 提取关键发现，记录 URL、标题、要点、相关度评分
+
+输出格式：
+## {query}
+### 结果 1：{title}
+- URL: {url}
+- 相关度：{1-5}/5
+- 关键发现：...
+---
+
+注意事项：
+  - 需要安装 kimi CLI 工具
+  - 复杂任务可能需要较长时间（最长 5 分钟）
+  - 指令越详细，结果质量越高`,
+    inputSchema: AgentInstructionSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true
+    }
+}, async (params) => {
+    try {
+        const result = await executeKimiAgent(params.instruction);
+        return {
+            content: [{ type: "text", text: result }]
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{
+                    type: "text",
+                    text: `任务执行出错: ${errorMessage}`
+                }]
+        };
+    }
+});
+// 主函数
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("kimi-search MCP Server 正在通过 stdio 运行");
+}
+main().catch(error => {
+    console.error("服务器错误:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@lionad/kimi-search",
+  "version": "0.0.1",
+  "description": "MCP server for kimi search integration",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "main": "dist/index.js"
+  },
+  "scripts": {
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.6.1",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  }
+}

package/src/index.ts

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+/**
+ * kimi-search MCP Server
+ *
+ * 此服务器将 kimi 作为智能代理(agent)暴露给 MCP 客户端，
+ * 支持执行复杂的搜索、分析和信息整合任务。
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { execFile } from "child_process";
+import { promisify } from "util";
+
+const execFileAsync = promisify(execFile);
+
+// Zod 模式用于输入验证
+const AgentInstructionSchema = z.object({
+  instruction: z.string()
+    .min(1, "指令不能为空")
+    .max(5000, "指令不能超过 5000 个字符")
+    .describe(`完整的任务指令，描述需要 kimi-search 执行的搜索或分析任务。
+
+指令应包含：
+1. 搜索关键词或搜索主题
+2. 具体目标（要获取什么信息）
+3. 执行步骤（如何获取和处理信息）
+4. 输出格式要求
+
+示例指令：
+---
+搜索："bun package manager vs pnpm benchmark 2025"
+
+目标：了解 Bun 作为新兴 JavaScript 包管理器与 pnpm 的对比，包括性能基准测试和功能差异
+
+使用 WebSearch 工具执行网络搜索。
+对于每个相关结果：
+1. 使用 WebFetch 或浏览器工具获取页面内容
+2. 提取与搜索目标相关的关键发现
+3. 记录：URL、标题、要点、相关度评分（1-5）
+
+以以下格式返回结构化结果：
+\`\`\`
+## {query}
+
+### 结果 1：{title}
+- URL: {url}
+- 相关度：{1-5}/5
+- 关键发现：
+  - {要点}
+- 引用：
+  - "{相关摘录}"
+\`\`\`
+
+关注事实信息和有数据支持的论断。
+---`)
+}).strict();
+
+type AgentInstruction = z.infer<typeof AgentInstructionSchema>;
+
+// 执行 kimi-search 任务
+async function executeKimiAgent(_instruction: string): Promise<string> {
+  const instruction = `## Context\n* use 90 seconds timeout for tools\n\n以下是具体的网络搜索或分析任务\n\n---\n\n${_instruction}`
+  try {
+    const { stdout } = await execFileAsync("kimi", [
+      "-p",
+      instruction,
+      "--print",
+      "--output-format",
+      "stream-json",
+      "--final-message-only"
+    ], {
+      timeout: 180000, // 3 分钟超时，给 agent 足够时间完成复杂任务
+      maxBuffer: 10 * 1024 * 1024 // 10MB 缓冲区
+    });
+
+    return stdout.trim();
+  } catch (error) {
+    if (error instanceof Error) {
+      if (error.message.includes("ENOENT")) {
+        throw new Error("未找到 kimi 命令。请确保 kimi CLI 已安装并添加到 PATH 中。");
+      }
+      if (error.message.includes("ETIMEDOUT")) {
+        throw new Error("任务执行超时。kimi-search 可能需要更长时间处理复杂任务，请稍后重试或简化任务。");
+      }
+      throw new Error(`任务执行失败: ${error.message}`);
+    }
+    throw error;
+  }
+}
+
+// 创建 MCP 服务器实例
+const server = new McpServer({
+  name: "kimi-search-mcp-server",
+  version: "0.0.1"
+});
+
+// 注册 kimi-search 工具
+server.registerTool(
+  "kimi-search",
+  {
+    title: "kimi-search",
+    description: `将 kimi 作为智能代理(agent)执行复杂的搜索和分析任务。
+
+与简单的搜索工具不同，kimi-search 可以：
+- 进行多步骤的网络搜索
+- 分析和比较多个信息源
+- 生成结构化的报告和总结
+- 执行需要推理的复杂查询
+
+参数：
+  - instruction (string): 完整的任务指令，包含搜索关键词、目标、执行步骤和输出格式要求
+
+返回值：
+  kimi-search 完成任务的完整输出，通常包含搜索结果、分析或总结。
+
+使用场景对比：
+  ❌ 不适合：简单的关键词查询（如 "React"）
+  ✅ 适合：结构化的任务指令（包含目标、步骤、格式要求）
+
+示例指令结构：
+---
+搜索："bun package manager vs pnpm benchmark 2025"
+
+目标：了解 Bun 作为新兴 JavaScript 包管理器与 pnpm 的对比
+
+执行步骤：
+1. 使用 WebSearch 工具执行网络搜索
+2. 对于每个相关结果，获取页面内容
+3. 提取关键发现，记录 URL、标题、要点、相关度评分
+
+输出格式：
+## {query}
+### 结果 1：{title}
+- URL: {url}
+- 相关度：{1-5}/5
+- 关键发现：...
+---
+
+注意事项：
+  - 需要安装 kimi CLI 工具
+  - 复杂任务可能需要较长时间（最长 5 分钟）
+  - 指令越详细，结果质量越高`,
+    inputSchema: AgentInstructionSchema,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    }
+  },
+  async (params: AgentInstruction) => {
+    try {
+      const result = await executeKimiAgent(params.instruction);
+
+      return {
+        content: [{ type: "text", text: result }]
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      return {
+        content: [{
+          type: "text",
+          text: `任务执行出错: ${errorMessage}`
+        }]
+      };
+    }
+  }
+);
+
+// 主函数
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("kimi-search MCP Server 正在通过 stdio 运行");
+}
+
+main().catch(error => {
+  console.error("服务器错误:", error);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "allowSyntheticDefaultImports": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}