{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_3c86t32x2kjf","handle":"doubao-search-mcp","url":"https://wellknown.network/agents/doubao-search-mcp","links":{"self":"https://wellknown.network/agents/doubao-search-mcp/record.json","html":"https://wellknown.network/agents/doubao-search-mcp","markdown":"https://wellknown.network/agents/doubao-search-mcp/record.md","api":"https://wellknown.network/api/v1/agents/doubao-search-mcp","status":"https://wellknown.network/api/v1/agents/doubao-search-mcp/status","claim":"https://wellknown.network/agents/doubao-search-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/doubao-search-mcp/claim.json","badge":"https://wellknown.network/agents/doubao-search-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/doubao-search-mcp/history","tools":"https://wellknown.network/api/v1/agents/doubao-search-mcp/tools"},"ard":{"identifier":"urn:air::server:doubao-search-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"doubao-search-mcp","summary":"MCP server for Doubao (Volcengine) web search API — 联网搜索能力","description":"# doubao-search-mcp\n\n基于火山引擎**豆包联网搜索 API** 的 MCP 服务，提供 `web_search` 工具（网页 / 图片搜索），帮助大模型 / AI Agent 获取更准确、更新鲜的外部信息。\n\n> 本包复刻自火山官方 [`volcengine/mcp-server`](https://github.com/volcengine/mcp-server) 的 `mcp_server_askecho_search_infinity`（MIT 协议），修复了 mcp SDK 2.x 下的导入崩溃问题，并独立发布到 PyPI。\n\n## 功能\n\n提供 `web_search` 工具：\n\n| 参数 | 类型 | 默认 | 说明 |\n|---|---|---|---|\n| `Query` | str | — | 搜索 query，1~100 个字符（必填） |\n| `Count` | int | 10 | 返回条数；web 最多 50，image 最多 5 |\n| `SearchType` | str | `web` | 仅支持 `web` 或 `image` |\n| `TimeRange` | str | 空 | `OneDay`/`OneWeek`/`OneMonth`/`OneYear` 或日期区间 `YYYY-MM-DD..YYYY-MM-DD` |\n| `AuthLevel` | int | 0 | 权威等级过滤；0 默认，1 非常权威 |\n\n## 安装运行\n\n需要 Python 3.12 / 3.13 与 [uv](https://docs.astral.sh/uv/)。\n\n```bash\n# 免安装直接运行（首次自动从 PyPI 拉取）\nuvx doubao-search-mcp\n\n# 或安装成常驻工具\nuv tool install doubao-search-mcp\ndoubao-search-mcp\n```\n\n### 传输方式\n\n默认 stdio；也支持 SSE / streamable-http：\n\n```bash\nuvx doubao-search-mcp -t sse\nuvx doubao-search-mcp -t streamable-http\n```\n\n## 鉴权\n\n**二选一**，通过环境变量提供（两者都不配置会启动失败，日志提示 Authentication missing）：\n\n| 方式 | 环境变量 |\n|---|---|\n| API Key | `ASK_ECHO_SEARCH_INFINITY_API_KEY` |\n| 火山引擎 AK/SK | `VOLCENGINE_ACCESS_KEY` + `VOLCENGINE_SECRET_KEY` |\n\n- 服务开通：https://console.volcengine.com/search-infinity/web-search\n- API Key 创建：https://console.volcengine.com/search-infinity/api-key\n\n## 客户端配置\n\n### Claude Code\n\n```bash\nclaude mcp add doubao-search-mcp \\\n  -e ASK_ECHO_SEARCH_INFINITY_API_KEY=你的Key \\\n  -- uvx doubao-search-mcp\n```\n\n### 通用 mcp.json / claude_desktop_config.json\n\n```json\n{\n  \"mcpServers\": {\n    \"doubao-search-mcp\": {\n      \"command\": \"uvx\",\n      \"args\": [\"doubao-search-mcp\"],\n      \"env\": {\n        \"ASK_ECHO_SEARCH_INFINITY_API_KEY\": \"你的Key\"\n      }\n    }\n  }\n}\n```\n\n## 为什么锁 `mcp<2`\n\n官方源码依赖 `mcp>=1.9.4` 未锁上限，而 mcp Python SDK 2.x 移除了 `mcp.server.FastMCP` 的导入路径，导致服务启动即崩溃。本包将依赖锁定为 `mcp>=1.9.4,<2`，保证在最新 1.x 上稳定运行；待上游适配 2.x 后再考虑升级。\n\n## License\n\nMIT。源码源自 [volcengine/mcp-server](https://github.com/volcengine/mcp-server)。","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["doubao","mcp","search","volcengine","web-search"],"pricing":null,"endpoints":[{"url":"pypi:doubao-search-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.web-search","name":"Web Search","confidence":1,"provenance":"declared"}],"categories":["data"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"doubao-search-mcp","registry":"pypi","observedAt":"2026-10-27T23:25:40.636Z","publishedAt":"2026-08-02T05:39:22.974277Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"doubao-search-mcp","url":"https://pypi.org/project/doubao-search-mcp/","firstSeenAt":"2026-09-09T14:32:15.964Z","fetchedAt":"2026-10-27T23:25:03.998Z","normalizedAt":"2026-10-27T23:25:03.998Z"}]},"firstSeenAt":"2026-09-09T14:32:15.964Z","updatedAt":"2026-10-27T23:25:40.636Z"}