# xinkuang-china-stock-mcp

Give an agent tools for querying China and Hong Kong stock information, from quotes to company accounts. Connect it when those market details need to be available in Claude Code.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 46
- Author: xinkuang
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/xinkuang/china-stock-mcp
- Updated: 2026-03-09
- HTML: https://affpapa.org/en/nevibecode/mcp/xinkuang-china-stock-mcp

## What it does

The server exposes queries for current and past prices, company statements, stock news, ownership details and macroeconomic indicators. Historical price requests can include technical indicators, and results can be returned in formats such as JSON, CSV or Markdown.

It draws from multiple data providers and can try another provider when the preferred one fails. Memory and disk caching are part of the setup, so cached results can matter when you request current prices again. The project also describes stdio and HTTP operation, plus Docker deployment. Its tools cover China A-shares and Hong Kong stocks.

## Requirements
- Remote server: `https://server.smithery.ai/@xinkuang/china-stock-mcp/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http xinkuang-china-stock-mcp https://server.smithery.ai/@xinkuang/china-stock-mcp/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add xinkuang-china-stock-mcp --url https://server.smithery.ai/@xinkuang/china-stock-mcp/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "xinkuang-china-stock-mcp": {
            "url": "https://server.smithery.ai/@xinkuang/china-stock-mcp/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "xinkuang-china-stock-mcp": {
            "type": "http",
            "url": "https://server.smithery.ai/@xinkuang/china-stock-mcp/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http xinkuang-china-stock-mcp https://server.smithery.ai/@xinkuang/china-stock-mcp/mcp
```

## When to use it
- look up a current quote or historical prices for a stock
- add technical indicators to historical market data
- retrieve a company balance sheet or cash flow statement
- check stock-related news and ownership details
- query a macroeconomic indicator or investor sentiment

## Example prompts
- Get the current quote for stock `000001` as JSON.
- Compare historical prices for `000001` over the requested dates and include `RSI` and `MACD`.
- Find recent news about stock `000001` and summarize the main points.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md