MiMo Web Search MCP Server
一个基于 Model Context Protocol (MCP) 的服务器,将小米 MiMo 的 web_search API 封装为标准 MCP 工具,让 Claude Code 等 AI 助手能够进行实时网络搜索。
本地单用户工具:面向本机 Claude Code 使用。
mimo_web_fetch允许访问 localhost、私有 IP 与任意端口,便于调试本机/内网服务;不要作为共享服务暴露给不可信远程用户。
功能特性
- 🔍 实时网络搜索 - 获取最新的网络信息
- 🌐 网页抓取 - 抓取并提取指定 URL 的网页正文内容(含本机/内网)
- 📊 结构化结果 - 返回标题、URL、摘要和来源引用
- 🔄 自动重试 - 内置重试机制和超时控制
- 📝 详细日志 - 通过 DEBUG 环境变量控制日志级别
- 🛡️ 类型安全 - 完整的 TypeScript 类型定义
前置要求
- Node.js >= 20.0.0
- MiMo API Key(从 MiMo 平台 获取)
快速开始
安装方式:仅提供源码安装。npm 渠道(
npm install -g/npx)后续不再提供与更新。
从源码安装
# 克隆并安装
git clone https://github.com/1Lurgee/mimo-web-search-mcp.git
cd mimo-web-search-mcp
npm install
npm run build
Claude Code 配置
编辑 ~/.claude.json 文件(Windows: %USERPROFILE%\.claude.json):
{
"mcpServers": {
"mimo-web-search": {
"type": "stdio",
"command": "node",
"args": ["<项目路径>/dist/index.js"],
"env": {
"MIMO_API_KEY": "your-api-key-here"
}
}
}
}
使用方法
配置完成后,Claude Code 会自动识别并可用以下工具:
mimo_web_search - 网络搜索
用户: 今天北京天气怎么样?
Claude: [自动调用 mimo_web_search 查询北京天气]
主要参数:query(必需)、limit(结果数量)、country/region/city(位置)
mimo_web_fetch - 网页抓取
用户: 帮我看看这篇文章 https://example.com/article
Claude: [自动调用 mimo_web_fetch 抓取网页内容]
主要参数:url(必需)、prompt(AI 处理指令)、clean(提取正文)
注意:
- SPA 页面(React/Vue)需要设置
MIMO_ENABLE_BROWSER=true并安装 playwright。 - URL 校验仅限制
http/https与长度;允许 localhost、私有 IP、任意端口与 URL 凭证。 - 带凭证的 URL 仍可请求,但日志与结果元数据中的凭证会被脱敏(
user:pass@→***:***@)。 - 自动重定向只跟随同协议/同端口/同主机(允许 www 增减);跨主机重定向需直接请求目标 URL。
环境变量
必需变量
可选变量
开发
npm run dev # 开发模式(热重载)
npm run build # 编译 TypeScript
npm test # 运行测试
npm run precommit # 提交前完整检查
许可证
MIT License - 详见 LICENSE 文件