hackerdogs/baidu-search-mcp-server-mcp repository overview

⁠

⁠Baidu Search MCP Server

MCP server wrapper for baidu-mcp-server⁠ — search Baidu's web index and retrieve results optimized for Chinese-language and Asia-Pacific queries.

⁠What is Baidu Search MCP?

Baidu is China's largest search engine and a primary index for Chinese-language content. The baidu-mcp-server Python package exposes Baidu web search as an MCP tool, enabling LLMs to submit queries to Baidu and receive structured search results including titles, URLs, and snippets. It is particularly useful for research targeting Chinese-language sources, news, and regional content that may not surface prominently on Western search engines.

No API keys required — this server queries Baidu's public web interface and runs entirely inside the Docker container.

⁠Tools Reference

⁠Example Prompts

Here are example prompts you can use with Claude (or any MCP client) when this tool is connected:

• "Search Baidu for '人工智能最新进展' and summarize the top results."
• "Use Baidu to find recent news about Alibaba Cloud's AI announcements."
• "Search Baidu for information about cybersecurity regulations in China."
• "Find Chinese-language developer documentation for the WeChat Mini Programs API using Baidu."
• "Search Baidu for the latest statistics on China's e-commerce market in 2024."
• "Use Baidu to look up the official documentation site for Baidu PaddlePaddle."

⁠Deploy

⁠Docker Compose (recommended)

docker-compose up -d

⁠Docker Run (stdio mode)

docker run -i --rm hackerdogs/baidu-search-mcp-server-mcp:latest

⁠Docker Run (HTTP streamable mode)

docker run -d -p 8628:8628 \
  -e MCP_TRANSPORT=streamable-http \
  -e MCP_PORT=8628 \
  hackerdogs/baidu-search-mcp-server-mcp:latest

⁠MCP Client Configuration

⁠Stdio mode (default)

Add to your Claude Desktop or Cursor MCP config:

{
  "mcpServers": {
    "baidu-search-mcp-server-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "hackerdogs/baidu-search-mcp-server-mcp:latest"
      ],
      "env": {
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

⁠HTTP mode (streamable-http)

First, start the server using Docker Compose or docker run with HTTP mode (see Deploy⁠ above), then point your MCP client at the running server:

{
  "mcpServers": {
    "baidu-search-mcp-server-mcp": {
      "url": "http://localhost:8628/mcp"
    }
  }
}

⁠Environment Variables

⁠Installing in Hackerdogs

The fastest way to get started is through Hackerdogs⁠:

1. Log in to your Hackerdogs account.
2. Go to the Tools Catalog.
3. Search for the tool by name.
4. Expand the tool card and click Install — you're ready to go.

1. Vendor API key required? Add your key in the config environment variable field before clicking Install. Your key will be encrypted at rest.
2. Enable / Disable the tool anytime from the Enabled Tools page.
3. Need to update a key or parameter? Go to My Tools → toggle Show Decrypted Values → edit → Save.

⁠Build

docker build -t hackerdogs/baidu-search-mcp-server-mcp:latest .

⁠Testing

⁠Automated tests

./test.sh

⁠Test directly with Docker

1. Start the server in HTTP mode:

docker run -d --rm --name baidu-search-mcp-server-mcp-test -p 8628:8628 \
  -e MCP_TRANSPORT=streamable-http \
  hackerdogs/baidu-search-mcp-server-mcp:latest

2. Initialize the MCP session:

SESSION_ID=$(curl -s -D - -X POST http://localhost:8628/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1"}}}' \
  2>&1 | grep -i mcp-session-id | awk '{print $2}' | tr -d '\r\n')

curl -s -X POST http://localhost:8628/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

3. List available tools:

curl -s -X POST http://localhost:8628/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

4. Clean up:

docker stop baidu-search-mcp-server-mcp-test