How do I use AkShare MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@AkShare MCP Server Show me the real-time price and basic info for stock 600246" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

AkShare MCP Server by qiupo

基于 AkShare 库的金融数据 MCP (Model Context Protocol) 服务器，提供全面的股票、基金、期货等金融数据查询功能。

功能特性

📈 股票市场数据

A股实时行情 - 沪深京A股实时行情数据
历史行情数据 - 支持日线、周线、月线，可复权
个股信息查询 - 基本面信息、财务数据
分时数据 - 分钟级K线数据
板块数据 - 新股、风险警示板等

🌏 多市场支持

A股市场 - 沪深京全市场覆盖
港股市场 - 港股数据支持
美股市场 - 美股实时行情（新浪财经）

📊 数据分析工具

同行比较 - 估值、成长性、财务指标对比
风险警示 - ST股票、退市股票信息
股市日历 - 公司动态、重要事件
技术指标 - 支持各类技术分析指标

安装设置

1. 环境要求

Node.js >= 16
Python >= 3.8
akshare 库

2. 安装依赖

# 安装 Node.js 依赖 npm install # 安装 Python akshare 库 pip install akshare pandas

3. 构建项目

npm run build

4. 配置 Claude Code

配置内容：

{ "mcpServers": { "akshare-mcp": { "command": "node", "args": ["/path/marketMcp/dist/index.js"], } } }

5. 启动服务

npm start

6. 验证配置

重启 Claude Code 后，您就可以使用以下金融数据工具：

A股实时行情查询
历史K线数据（支持复权）
个股基本信息查询
港股、美股数据
同行估值比较分析

可用工具

市场行情类

工具名	描述	参数
`stock_sh_a_spot_em`	沪A股实时行情	`limit` (可选)
`stock_sz_a_spot_em`	深A股实时行情	`limit` (可选)

实时报价类（新增）

工具名	描述	参数
`stock_individual_spot_xq`	个股实时行情数据（雪球）	`symbol` (必需) - 股票代码
`realtime_quote`	实时行情数据	`symbol` (必需) - 支持多只股票，逗号分隔
`stock_global_realtime`	全球股市实时行情数据	`region` (可选) - 地区：中国/香港/美国/欧洲/亚洲/全球
`stock_hk_spot_em`	港股实时行情数据	`limit` (可选) - 数据条数限制
`stock_us_spot`	美股实时行情数据（新浪）	`symbol` (可选) - 支持多只股票，逗号分隔

历史数据类

工具名	描述	参数
`stock_zh_a_hist`	A股历史行情	`symbol` (必需), `period`, `start_date`, `end_date`, `adjust`
`stock_zh_a_minute`	分时数据	`symbol` (必需), `period`, `adjust`

个股信息类

工具名	描述	参数
`stock_individual_basic_info_xq`	个股基本信息	`symbol` (必需)

市场分析类

工具名	描述	参数
`stock_gsrl_gsdt_em`	股市日历公司动态	`date` (必需)

特殊板块类

工具名	描述	参数
`stock_zh_a_new_em`	新股数据	`limit` (可选)
`stock_zh_a_st_em`	风险警示板数据	`limit` (可选)

使用示例

1. 获取A股实时行情

{ "tool": "stock_sh_a_spot_em", "arguments": { "limit": 10 } }

2. 查询个股历史行情

{ "tool": "stock_zh_a_hist", "arguments": { "symbol": "600246", "period": "daily", "start_date": "20241201", "end_date": "20241205", "adjust": "qfq" } }

3. 获取个股基本信息

{ "tool": "stock_individual_basic_info_xq", "arguments": { "symbol": "600246" } }

4. 获取个股实时行情（雪球）

{ "tool": "stock_individual_spot_xq", "arguments": { "symbol": "600246" } }

5. 获取多只股票实时行情

{ "tool": "realtime_quote", "arguments": { "symbol": "600246,600000,000002" } }

7. 获取全球股市实时行情

{ "tool": "stock_global_realtime", "arguments": { "region": "中国" } }

8. 获取港股实时行情

{ "tool": "stock_hk_spot_em", "arguments": { "limit": 50 } }

9. 获取美股实时行情（新浪）

{ "tool": "stock_us_spot", "arguments": { "symbol": "AAPL,MSFT,GOOGL" } }

测试

运行测试脚本验证服务功能：

npm test

或者直接运行：

node test/mcp-test.js

数据源

本服务器基于 AkShare 库，数据来源于：

东方财富网
上海证券交易所
深圳证券交易所
新浪财经
腾讯财经
雪球财经

注意事项

数据延迟：实时行情数据可能有15分钟延迟
访问频率：请合理控制API调用频率，避免被限制
免责声明：本服务仅提供数据展示，不构成投资建议
数据准确性：请以官方数据为准，本数据仅供参考

故障排除

常见问题

akshare库未安装

pip install akshare pandas

Python版本不兼容 确保使用 Python 3.8+
权限问题 确保脚本有执行权限
网络连接问题 检查网络连接，某些数据源可能需要特殊网络环境

开发

项目结构

├── src/ │ └── index.ts # MCP服务器主文件 ├── test/ │ └── mcp-test.js # 测试脚本 ├── dist/ # 编译输出目录 ├── akshare_service.py # Python服务脚本 ├── package.json # Node.js项目配置 ├── tsconfig.json # TypeScript配置 └── README.md # 项目文档

添加新工具

在 src/index.ts 中的 getToolDefinitions 方法中添加工具定义
Python服务会自动调用对应的akshare函数
在 test/mcp-test.js 中添加相应的测试用例

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request！

更新日志

v1.0.0

初始版本发布
支持基础的股票数据查询功能
包含完整的测试套件

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

AkShare MCP 服务器