iflow-search-mcp

# iflow-search-mcp [](https://pypi.org/project/iflow-search-mcp/) [](https://pypi.org/project/iflow-search-mcp/) **MCP stdio server for [iFlow Search](https://platform.iflow.cn/) (心流搜索).** Exposes three MCP tools backed by the `iflow-search` core SDK: - `iflow_web_search` — web search - `iflow_image_search` — image search - `iflow_web_fetch` — fetch the readable contents of a URL This package is a thin adapter. All HTTP, authentication, attribution-header construction, response normalization, and error mapping live in the [`iflow-search`](https://pypi.org/project/iflow-search/) core SDK. This package owns only the MCP server wiring — tool definitions, tool dispatch, and the stdio entry point. ## Install ```bash pip install iflow-search-mcp ``` > Installing pulls in the MCP Python SDK, which transitively depends on > `starlette`, `uvicorn`, `sse-starlette`, `python-multipart`, > `pyjwt[crypto]`, and `jsonschema` — even though this server only uses > stdio. There is no `[stdio]` extra on the upstream package. ## Configure your MCP host The server reads its configuration from environment variables only — no `.env` files, no CLI flags, no config files. | Variable | Required | Notes | |---|---|---| | `IFLOW_API_KEY` | yes | iFlow API key | | `IFLOW_BASE_URL` | no | Override the platform base URL | | `IFLOW_TIMEOUT_MS` | no | Request timeout in milliseconds (positive integer) | | `IFLOW_MCP_CLIENT` | no | Identifier for the MCP host (e.g. `claude-desktop`); regex `^[a-z0-9._-]{1,64}$` | | `IFLOW_MCP_CLIENT_VERSION` | no | Version of the MCP host; only valid when `IFLOW_MCP_CLIENT` is set | ### Example: Claude Desktop / Claude Code ```jsonc { "mcpServers": { "iflow-search": { "command": "iflow-search-mcp", "env": { "IFLOW_API_KEY": "sk-..." } } } } ``` Claude Code…