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
一个将小米 MiMo 的 web_search API 包装为 Claude Code 可用的 MCP 工具的服务器。
功能特性
🔍 实时网络搜索:使用小米 MiMo 的 web_search 插件进行实时搜索
📍 位置感知搜索:支持按国家、地区、城市进行本地化搜索
🔄 自动重试:网络错误或服务暂时不可用时自动重试
⏱️ 超时控制:防止请求无限期挂起
🛡️ 错误处理:友好的错误提示和恢复建议
🧹 优雅关闭:正确处理进程信号和异常
Related MCP server: Kimi Coding MCP
安装
npm install配置
环境变量
变量 | 必需 | 说明 |
| 是 | MiMo API 密钥 |
| 否 | API 基础 URL,默认 |
| 否 | 请求超时时间(毫秒),默认 |
| 否 | 最大生成 token 数,默认 |
| 否 | 采样温度(0-2),默认 |
| 否 | 核采样概率(0-1),默认 |
| 否 | 日志级别:0=错误(默认),1=信息,2=调试 |
Claude Code 配置
1. MCP 服务器配置
在 Claude Code 的 MCP 配置文件中添加:
{
"mcpServers": {
"mimo-web-search": {
"command": "node",
"args": ["path/to/mimo-web-search-mcp/server.mjs"],
"env": {
"MIMO_API_KEY": "your-api-key-here"
}
}
}
}2. 全局指令配置(推荐)
在全局 CLAUDE.md 中添加,让 Claude Code 在所有项目中都知道这个 MCP 工具:
文件位置:~/.claude/CLAUDE.md
# 全局指令
## 网络搜索工具
当需要搜索网络信息时,优先使用 `mimo_web_search` MCP 工具。使用方法
MCP 工具
服务器提供一个工具:mimo_web_search
参数
参数 | 类型 | 默认值 | 说明 |
| string | 必需 | 搜索查询 |
| int (1-50) | 3 | 每轮最大并发关键词数 |
| int (1-50) | 5 | 返回结果数量 |
| boolean | true | 强制搜索 |
| string | 可选 | 国家 |
| string | 可选 | 地区 |
| string | 可选 | 城市 |
示例
{
"query": "最新的人工智能进展",
"max_keyword": 5,
"limit": 10,
"country": "China"
}返回格式
成功响应:
搜索结果内容...
--- Sources ---
- [标题](URL) — 网站名 (发布时间)
--- Usage ---
Search calls: 3, Pages: 10
Tokens: 1500 (prompt: 500, completion: 1000)错误响应:
错误描述和恢复建议安全说明
本 MCP 服务器仅作为 MiMo 搜索 API 的透传层,不对返回内容做提示词注入过滤。防御提示词注入是 Client 端(Claude Code 等)的职责,建议在使用搜索结果时保持警惕。
错误处理
服务器会分类处理各种错误情况:
认证错误 (401/403):提示检查 API 密钥
速率限制 (429):提示稍后重试
服务器错误 (5xx):提示服务暂时不可用
超时错误:提示服务响应缓慢
网络错误:提示检查网络连接
开发
项目结构
mimo-web-search-mcp/
├── server.mjs # MCP 服务器主文件
├── package.json # 项目配置
├── CLAUDE.md # Claude Code 指令
└── README.md # 项目说明技术栈
运行时: Node.js (ESM 模块)
MCP SDK:
@modelcontextprotocol/sdkv1.x传输协议: stdio (标准输入/输出)
验证: Zod schema
许可证
MIT 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
Latest Blog Posts
- 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