README

xueqiu-mcp

雪球股票数据 MCP Server，提供 A股、港股、美股的实时行情查询。

功能

工具	说明
`search_stock`	搜索股票，返回匹配的股票列表（代码、名称、市场类型）
`get_stock`	查询单只股票详细数据（价格、涨跌幅、盘前盘后、成交量/额、量比、市值、市盈率、市净率、市销率、股息率、交易状态等）
`get_stocks`	批量查询多只股票的实时价格、涨跌额、涨跌幅和成交额
`get_market_index`	查询大盘指数行情（价格、涨跌额、涨跌幅），支持 A股(cn)、美股(us)、港股(hk)

安装

bunx（推荐）

无需安装，直接在 MCP 客户端配置中使用：

{
  "mcpServers": {
    "xueqiu-mcp": {
      "command": "bunx",
      "args": ["-y", "xueqiu-mcp@latest"]
    }
  }
}

全局安装

npm install -g xueqiu-mcp

配置

Claude Code

claude mcp add xueqiu-mcp -- bunx -y xueqiu-mcp@latest

HTTP 模式

如果需要通过 HTTP 方式接入：

MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3000 bunx xueqiu-mcp@latest

服务启动后，MCP 端点为 http://localhost:3000/mcp。

使用示例

配置完成后，在 AI 对话中直接提问即可：

"搜索腾讯相关的股票"
"查一下茅台的股价"
"帮我看看 AAPL 和 TSLA 的行情"
"今天 A股大盘怎么样"

开发

# 安装依赖
bun install

# 启动（stdio 模式）
bun run start

# 启动（HTTP 模式）
bun run start:http

# 使用 MCP Inspector 调试
bun run inspector

# 代码检查
bun run check

# 构建
bun run build

许可证

MIT

xueqiu-mcp

README

xueqiu-mcp

功能

安装

bunx（推荐）

全局安装

配置

Claude Code

HTTP 模式

使用示例

开发

许可证

Recommended Servers