alibabacloud-iqs-tongxiao

This MCP server implements TongXiao Common Search by integrating with IQS APIs to deliver clean, accurate, diverse, and high-quality search results from multiple data sources. It exposes a real-time search experience by wiring TongXiao's data sources into the MCP framework so clients can query across open-domain and vertical data. The server can run in stdio mode or as an SSE server depending on how you configure the environment. To use it, obtain a TongXiao API key and provide it via the TONGXIAO_API_KEY environment variable when starting the server. You can run the MCP server with npx for a quick test, or install it globally for repeated use. When using an MCP client, configure the client to point at the TongXiao MCP server entry, typically using the npx-based invocation shown below and supplying the required API key.

Key capabilities include:

• Real-time search with multi-source aggregation
• Open-domain and vertical data integration via TongXiao IQS APIs
• Easy MCP client configuration for querying and streaming results

To run as the standard stdio server:

• Provide your API key and start via npx (stdio mode): env TONGXIAO_API_KEY=your-api-key npx -y @tongxiao/common-search-mcp-server

To run as an SSE server (streaming): env TONGXIAO_API_KEY=your-api-key SERVER=sse npx -y @tongxiao/common-search-mcp-server

If you’re embedding in a client, configure the MCP server entry with the npm-based invocation: { "mcpServers": { "tongxiao-common-search": { "command": "npx", "args": [ "-y", "@tongxiao/common-search-mcp-server" ], "env": { "TONGXIAO_API_KEY": "" } } } }

• Prerequisites:

  • Node.js (recommended LTS) and npm installed on your system
  • Access to install global npm packages if you plan to run globally

• Quick installation (global):

  1. Install the MCP server globally so you can run it from anywhere: npm install -g @tongxiao/common-search-mcp-server
  2. Verify installation by running the help command (adjust as needed): tongxiao-common-search-mcp-server --help

• Running with npx (no global install):

  1. Ensure you have Node.js and npm installed.
  2. Run the MCP server directly with npx: env TONGXIAO_API_KEY=your-api-key npx -y @tongxiao/common-search-mcp-server

• Environment and options:

  • To run in streaming (SSE) mode, set SERVER=sse: env TONGXIAO_API_KEY=your-api-key SERVER=sse npx -y @tongxiao/common-search-mcp-server

• Client integration (example JSON): You can also configure the MCP client to invoke the server via npx in your own project: { "mcpServers": { "tongxiao-common-search": { "command": "npx", "args": ["-y", "@tongxiao/common-search-mcp-server"], "env": {"TONGXIAO_API_KEY": ""} } } }

Tips and common issues:

• Ensure your TONGXIAO_API_KEY is valid and has sufficient permissions for IQS data sources.
• When running in SSE mode, ensure your client supports streaming responses and that the environment (e.g., reverse proxies) allows long-lived connections.
• If you encounter network or API key errors, double-check the API key scope and any IP restrictions on the TongXiao IQS API key dashboard.
• For local development, using npx avoids global package management but ensure you’re connected to the internet to fetch the package.
• If you need to run multiple instances, you can duplicate the mcpServers entry with distinct server names and separate environment configurations.