iflow-search-mcp 0.1.0a0

MCP (Model Context Protocol) stdio server for iFlow Search (心流搜索) — exposes web_search, image_search, and web_fetch as MCP tools.

iflow-search-mcp

MCP stdio server for iFlow Search (心流搜索).

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 core SDK. This package owns only the MCP server wiring — tool definitions, tool dispatch, and the stdio entry point.

Install

pip install --pre iflow-search-mcp

The package is currently published as a PEP 440 prerelease (0.1.0a0), so the --pre flag is required. 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

{
  "mcpServers": {
    "iflow-search": {
      "command": "iflow-search-mcp",
      "env": {
        "IFLOW_API_KEY": "sk-..."
      }
    }
  }
}

Behavior

• Transport: stdio only. stdout is reserved for the JSON-RPC stream; all human-readable output (banner, errors) goes to stderr.
• Exit codes: 0 on clean shutdown after SIGINT / SIGTERM, 1 on configuration or init error.
• Errors: tool failures return isError: true results with a stable structuredContent.error.code (mirroring the core SDK's error contract).

License

MIT. See LICENSE.