kimi-search-mcp

基于 Node.js 的本地 stdio MCP Server，将 Kimi 开放平台的联网搜索 Basic、联网搜索 Pro 和网页抓取 REST API 封装为三个 MCP 工具。

工具

工程特性：

• 纯本地 stdio 模式，无需部署 HTTP 服务

• API Key 只从环境变量 MOONSHOT_API_KEY 读取

• 408、429 和部分 5xx 错误自动重试，最多 3 次

• 搜索超时参数为 1–60 秒，客户端额外预留 10 秒网络时间

• 日志只写入 stderr，不干扰 stdio MCP 协议

Related MCP server: web-tools-mcp

要求

• Node.js 18 或更高版本

• Kimi API 开放平台的 API Key

安装

git clone https://github.com/Wildare-98/kimi-search-mcp.git
cd kimi-search-mcp
npm install

Kimi Code 配置

在用户级 ~/.kimi-code/mcp.json 或项目级 .kimi-code/mcp.json 中加入：

{
  "mcpServers": {
    "kimi-search": {
      "command": "node",
      "args": ["D:/AIFile/kimicode/Chatbot/kimi-search-mcp/index.js"],
      "env": {
        "MOONSHOT_API_KEY": "sk-你的key"
      }
    }
  }
}

将 args 中的路径替换为实际绝对路径。也可以把 MOONSHOT_API_KEY 设为系统环境变量，然后删除配置中的 env 段，避免把密钥写入配置文件。

新增配置只会注册到新会话。保存后新建会话，使用 /mcp 检查连接状态。

其他支持相同 JSON 配置的 MCP 客户端也可使用该配置，只需调整绝对路径。

使用建议

1. 普通搜索先调用 kimi_search，保持 include_content=false。

2. 需要直接获取相关段落、限定站点或时间时，调用 kimi_search_pro。

3. 已知 URL 或需要阅读完整网页时，调用 kimi_fetch。

搜索查询应尽量包含明确的实体、时间和来源限定词。kimi_search_pro 的 time_window 日期格式支持 YYYY、YYYY-MM 和 YYYY-MM-DD，sites 最多包含 5 个站点。

可选环境变量

计费

三个接口按成功且非空的结果分别计费；失败、超时或空结果不计费。详见联网搜索定价。

API 文档

• 联网搜索 Basic

• 联网搜索 Pro

• 网页抓取