doubao-search-mcp

基于火山引擎豆包联网搜索 API 的 MCP 服务，提供 web_search 工具（网页 / 图片搜索），帮助大模型 / AI Agent 获取更准确、更新鲜的外部信息。

本包复刻自火山官方 volcengine/mcp-server 的 mcp_server_askecho_search_infinity（MIT 协议），修复了 mcp SDK 2.x 下的导入崩溃问题，并独立发布到 PyPI。

功能

提供 web_search 工具：

安装运行

需要 Python 3.12 / 3.13 与 uv。

# 免安装直接运行（首次自动从 PyPI 拉取）
uvx doubao-search-mcp

# 或安装成常驻工具
uv tool install doubao-search-mcp
doubao-search-mcp

传输方式

默认 stdio；也支持 SSE / streamable-http：

uvx doubao-search-mcp -t sse
uvx doubao-search-mcp -t streamable-http

鉴权

二选一，通过环境变量提供（两者都不配置会启动失败，日志提示 Authentication missing）：

• 服务开通：https://console.volcengine.com/search-infinity/web-search
• API Key 创建：https://console.volcengine.com/search-infinity/api-key

客户端配置

Claude Code

claude mcp add doubao-search-mcp \
  -e ASK_ECHO_SEARCH_INFINITY_API_KEY=你的Key \
  -- uvx doubao-search-mcp

通用 mcp.json / claude_desktop_config.json

{
  "mcpServers": {
    "doubao-search-mcp": {
      "command": "uvx",
      "args": ["doubao-search-mcp"],
      "env": {
        "ASK_ECHO_SEARCH_INFINITY_API_KEY": "你的Key"
      }
    }
  }
}

为什么锁 mcp<2

官方源码依赖 mcp>=1.9.4 未锁上限，而 mcp Python SDK 2.x 移除了 mcp.server.FastMCP 的导入路径，导致服务启动即崩溃。本包将依赖锁定为 mcp>=1.9.4,<2，保证在最新 1.x 上稳定运行；待上游适配 2.x 后再考虑升级。

License

MIT。源码源自 volcengine/mcp-server。