Xueqiu MCP

🚀 Snowball MCP Service

Leverage the Snowball API through the MCP service to effortlessly retrieve stock data via Claude or other AI assistants.

🚀 Quick Start

This project encapsulates the Snowball API based on pysnowball and offers services through the MCP protocol. It enables you to directly query stock data in AI assistants like Claude.

📦 Installation

This project uses uv for dependency management. Please follow these steps to install:

# Clone the repository
git clone https://github.com/liqiongyu/xueqiu_mcp.git
cd xueqiu_mcp

# Install dependencies using uv
uv venv && uv pip install -e .

📚 Documentation

Configure the Snowball Token

1. Create a .env file in the project root directory.
2. Add the following content:

XUEQIU_TOKEN=Your Snowball token

• Quick way:

echo 'XUEQIU_TOKEN="xq_a_token=xxxxx;u=xxxx"' > .env

For instructions on how to obtain the Snowball token, refer to the pysnowball documentation.

Run the Service

Use the following command to start the MCP service:

uv --directory /path/to/xueqiu_mcp run main.py

Alternatively, if you have configured Claude Desktop:

"xueqiu-mcp": {
  "args": [
    "--directory",
    "/path/to/xueqiu_mcp",
    "run",
    "main.py"
  ],
  "command": "uv"
}

✨ Features

• Retrieve real - time stock quotes.
• Query index returns.
• Obtain northbound trading data for the Shenzhen - Hong Kong and Shanghai - Hong Kong Stock Connect.
• Query fund - related data.
• Search for stock codes by keywords.

🖼️ Showcase

🙏 Acknowledgments

• pysnowball - The Python version of the Snowball stock data interface.
• fastmcp - The MCP service framework.

📄 License

MIT License