TongXiao Common Search

TongXiao Common Search MCP Server is a server that implements the Model Context Protocol (MCP) and integrates with IQS APIs to deliver clean, accurate, diverse, and high-quality results from multiple data sources. You can run it locally or deploy it to respond to MCP clients with real-time search capabilities across open-domain data sources.

How to use

You connect to this MCP server from your MCP client by configuring an MCP server entry that points to a local or remote process. The server exposes a standard MCP interface and uses your API key to fetch results from IQS-backed data sources. Use the client’s MCP configuration to reference the server by its name and runtime command, and ensure the API key is supplied where required.

Practical usage patterns include starting the server locally during development with a simple command and then querying it from your MCP client for real-time search results. When you deploy, you can run the server as a background process or as part of a containerized workflow, and your MCP client will route queries to it just like any other MCP endpoint.

How to install

Prerequisites you need on your machine: Node.js and npm installed. You can verify by running node -v and npm -v in your terminal.

Install the MCP server globally using npm.

npm install -g @tongxiao/common-search-mcp-server

Run the server locally using npx and provide your TongXiao API key. Choose the standard IO server by default.

env TONGXIAO_API_KEY=your-api-key npx -y @tongxiao/common-search-mcp-server

If you prefer an SSE (server-sent events) variant, start with the same API key but set the SERVER environment variable to sse.

env TONGXIAO_API_KEY=your-api-key SERVER=sse npx -y @tongxiao/common-search-mcp-server

Additional steps for client configuration

Configure the TongXiao MCP Server entry in your MCP client configuration so the client knows how to start and connect to the server. Use the same command and arguments shown here.

{
  "mcpServers": {
    "tongxiao_common_search": {
      "command": "npx",
      "args": [
        "-y",
        "@tongxiao/common-search-mcp-server"
      ],
      "env": {
        "TONGXIAO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Notes on API key and access

Your API key for TongXiao IQS APIs is issued from the API key management portal. Obtain the key from the portal and replace YOUR_API_KEY with the actual value when starting the server or configuring the client.

Security and best practices

Keep your API key secret and do not expose it in public configurations or logs. If you are deploying in a shared environment, consider using environment management to inject the key at runtime and rotate keys periodically.

Troubleshooting

If the server does not start as expected, check that Node.js and npm are installed, and verify that the API key is set correctly. Ensure the environment supports MCP client integrations and that the MCP client configuration points to the correct command and arguments.

Available tools

common_search

Offers enhanced real-time search capabilities across open-domain networks by combining large-model optimization with multiple data sources to deliver clean, accurate, diverse results.