mimo-web-search
The mimo-web-search server provides real-time internet search via the MiMo API, integrated as an MCP tool for Claude Code.
Real-time web search: Fetch up-to-date information on news, weather, stock prices, sports scores, and current events.
Location-aware search: Narrow results by specifying a
country,region, and/orcity.Customizable results: Control the number of results returned (1–50) via
limit, and concurrent keywords per search round (1–50) viamax_keyword.Forced search mode: Use
force_searchto ensure a live search runs even if the model believes it already knows the answer.Structured results: Returns titles, URLs, snippets, source citations, and usage statistics.
Automatic retries & timeout handling: Resilience against network errors and temporary service unavailability.
Graceful error handling: Clear, actionable messages for authentication issues, rate limits, server errors, and network failures.
Provides access to Xiaomi MiMo's web search API, enabling real-time web searches with location awareness and configurable parameters.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mimo-web-searchsearch for latest developments in quantum computing"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 类型定义
Related MCP server: Kimi Coding MCP
前置要求
Node.js >= 20.0.0
MiMo API Key(从 MiMo 平台 获取)
快速开始
方式 1:npm 全局安装(推荐)
# 全局安装
npm install -g mimo-web-search-mcp
# 或直接运行(无需安装)
npx mimo-web-search-mcp方式 2:从源码安装
# 克隆并安装
git clone https://github.com/1Lurgee/mimo-web-search-mcp.git
cd mimo-web-search-mcp
npm install
npm run buildClaude Code 配置
编辑 ~/.claude.json 文件(Windows: %USERPROFILE%\.claude.json):
使用 npm 全局安装(推荐)
{
"mcpServers": {
"mimo-web-search": {
"command": "npx",
"args": ["mimo-web-search-mcp"],
"env": {
"MIMO_API_KEY": "your-api-key-here"
}
}
}
}使用源码安装
{
"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。
环境变量
必需变量
变量 | 说明 |
| MiMo API 密钥 |
可选变量
变量 | 说明 | 默认值 |
| API 基础 URL |
|
| 模型名称(如 |
|
| 启用思考模式 |
|
| 超长内容自动摘要 |
|
| 启用浏览器渲染(SPA 降级) |
|
| 日志级别: |
|
| MiMo API 请求超时(毫秒) |
|
| 最大生成 token 数 |
|
| 采样温度(0 ~ 1.5) |
|
| 核采样概率(0.01 ~ 1.0) |
|
| 最大重试次数(0 ~ 10) |
|
| 重试延迟(毫秒,100 ~ 60000) |
|
| 最大内容长度(字节) |
|
| 最大并发请求数(1 ~ 100) |
|
| 默认最大关键词数(1 ~ 50) |
|
| 默认返回结果数(1 ~ 50) |
|
| 查询最大字符数(100 ~ 100000) |
|
| 网页抓取超时时间(毫秒) |
|
| 最大响应体大小(字节) |
|
开发
npm run dev # 开发模式(热重载)
npm run build # 编译 TypeScript
npm test # 运行测试
npm run precommit # 提交前完整检查许可证
MIT License - 详见 LICENSE 文件
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Tools
Related MCP Servers
- AlicenseBqualityDmaintenanceExposes the Synthetic API as an MCP tool to enable web searching within Claude and other compatible applications. It provides formatted search results including titles, URLs, and text snippets for enhanced model context.Last updated12822MIT
- Flicense-qualityDmaintenanceWraps the Kimi Coding Search and Fetch APIs into MCP tools for web searching and content retrieval. It enables LLMs to perform targeted searches and crawl web pages using standardized interfaces.Last updated1
- Alicense-qualityBmaintenanceProvides web search and page fetching tools for third-party models (e.g., DeepSeek, Qwen, Kimi) in Claude Code, with configurable search backends, Markdown output, and safety boundaries.Last updated56MIT
- Flicense-qualityDmaintenanceProvides fast, self-hosted web search and reliable web scraping using SearXNG and Crawl4AI, integrated as MCP tools for Claude Code.Last updated37
Related MCP Connectors
Serper MCP — wraps the Serper Google Search API (serper.dev)
Web search for AI agents — one tool across 6 engines, routed to the cheapest + cached.
Web search, news, page retrieval, sitemaps, and trending topics through Search1API.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/1Lurgee/mimo-web-search-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server