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 平台 获取）

快速开始

方式 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 build

Claude 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。

环境变量

必需变量

可选变量

开发

npm run dev          # 开发模式（热重载）
npm run build        # 编译 TypeScript
npm test             # 运行测试
npm run precommit    # 提交前完整检查

许可证

MIT License - 详见 LICENSE 文件