概览
What is Xueqiu MCP?
Xueqiu MCP is a Model Context Protocol server that wraps the Xueqiu (Snowball) API using pysnowball, enabling AI assistants like Claude to query stock data directly. It is intended for developers and investors who want to integrate Chinese stock market data into AI-driven workflows.
How to use Xueqiu MCP?
Install dependencies with uv venv && uv pip install -e . after cloning the repository. Obtain a Xueqiu token and store it in a .env file as XUEQIU_TOKEN. Start the service by running uv --directory /path/to/xueqiu_mcp run main.py or by configuring a Claude Desktop MCP client with the same uv command.
Key features of Xueqiu MCP
- Fetch real-time stock quotes
- Query index returns
- Retrieve Shenzhen–Hong Kong / Shanghai–Hong Kong northbound data
- Access fund-related data
- Search stock codes by keyword
Use cases of Xueqiu MCP
- Ask an AI assistant for a stock’s current price and intraday movement
- Check the day’s performance of a major index
- Look up northbound capital flow data without leaving a chat
- Find a stock’s symbol by searching its name or abbreviation
FAQ from Xueqiu MCP
What data does Xueqiu MCP provide?
It provides real-time quotes, index returns, northbound market data, fund data, and stock code search — all via the Xueqiu API.
Does Xueqiu MCP require an API key or token?
Yes, a valid Xueqiu token (xq_a_token) is required. The token must be placed in a .env file as XUEQIU_TOKEN. Instructions for obtaining a token are linked in the README.
What runtime dependencies does Xueqiu MCP need?
It requires Python, the uv package manager, and the pysnowball and fastmcp libraries (installed automatically via the provided setup).
How is the MCP server started and connected?
The server is run locally as a subprocess using the uv command. It uses stdio transport by default, as shown in the Claude Desktop configuration example.
Can I use Xueqiu MCP with other AI assistants besides Claude?
The README specifically mentions Claude and shows integration with Claude Desktop, but any MCP-compatible client should be able to use it.
