kimi-search-mcp
基于 Node.js 的本地 stdio MCP Server，将 Kimi 开放平台的联网搜索 Basic、联网搜索 Pro 和网页抓取 REST API 封装为三个 MCP 工具。
工具
| 工具 | Kimi API | 说明 |
|---|---|---|
kimi_search |
POST /v1/tools/search |
返回标题、URL、摘要、日期和来源权威性，可选网页正文 |
kimi_search_pro |
POST /v1/tools/search_pro |
返回相关正文片段，支持站点与发布时间过滤，适合问答、RAG 和研究 |
kimi_fetch |
POST /v1/tools/fetch |
抓取指定 HTTP/HTTPS 网页，返回标题和 Markdown 正文 |
工程特性：
- 纯本地 stdio 模式，无需部署 HTTP 服务
- API Key 只从环境变量
MOONSHOT_API_KEY读取 - 408、429 和部分 5xx 错误自动重试，最多 3 次
- 搜索超时参数为 1–60 秒，客户端额外预留 10 秒网络时间
- 日志只写入 stderr，不干扰 stdio 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 客户端也可使用该配置，只需调整绝对路径。
使用建议
- 普通搜索先调用
kimi_search，保持include_content=false。 - 需要直接获取相关段落、限定站点或时间时，调用
kimi_search_pro。 - 已知 URL 或需要阅读完整网页时，调用
kimi_fetch。
搜索查询应尽量包含明确的实体、时间和来源限定词。kimi_search_pro 的 time_window 日期格式支持 YYYY、YYYY-MM 和 YYYY-MM-DD，sites 最多包含 5 个站点。
可选环境变量
| 变量 | 默认值 | 说明 |
|---|---|---|
MOONSHOT_API_KEY |
无，必填 | Kimi API Key |
MOONSHOT_BASE_URL |
https://api.moonshot.cn/v1 |
API 基础地址，用于兼容代理或测试 |
计费
三个接口按成功且非空的结果分别计费；失败、超时或空结果不计费。详见联网搜索定价。