Advertise
MCP.so
Sign In
X

Xueqiu MCP Server

@liqiongyu

Repository

Basic information

Category

Other

Transports

stdio

Author

liqiongyu

Submitted by

Qiongyu Li

About Xueqiu MCP Server

# Xueqiu MCP

#xueqiu#stock-data#mcp-service

Xueqiu MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

Xueqiu MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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

Frequently asked questions

1

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.

2

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.

3

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).

4

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.

5

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.

Comments

More Other MCP servers

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Advertise