Xueqiu MCP

Name: Xueqiu MCP
Author: liqiongyu

@liqiongyu

代码仓库

关于 Xueqiu MCP

# Xueqiu MCP

#xueqiu #stock-data #mcp-service

基本信息

分类

其他

传输方式

stdio

发布者

liqiongyu

提交者

Qiongyu Li

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "xueqiu_mcp": {
      "command": "uv",
      "args": [
        "venv",
        "&&",
        "uv",
        "pip",
        "install",
        "-e",
        "."
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.