| Name | a-stock-mcp JSON |
| Version |
0.1.0
JSON |
| download |
| home_page | None |
| Summary | A Stock MCP Server - A Model Context Protocol server for accessing Chinese stock market data via AKShare |
| upload_time | 2025-10-10 03:30:33 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | MIT |
| keywords |
akshare
chinese-market
finance
mcp
stock
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# AKShare MCP Server
A Model Context Protocol (MCP) server for accessing Chinese stock market data via [AKShare](https://github.com/akfamily/akshare).
## 功能特性
- 🏢 **市场总览**: 获取上海、深圳交易所市场统计数据
- 📈 **个股查询**: 雪球、东方财富等平台个股实时行情
- 📊 **历史数据**: A股历史K线、分时数据
- 🔍 **行业分析**: 行业成交、地区交易排行
- 💰 **融资融券**: 融资融券统计数据
- 📋 **行情报价**: 五档买卖盘口数据
## 安装
```bash
pip install akshare-mcp
```
## 使用方法
### 命令行启动
```bash
akshare-mcp
```
### 作为 MCP 客户端使用
在支持 MCP 的应用（如 Claude Desktop）中配置：
```json
{
"mcpServers": {
"akshare": {
"command": "akshare-mcp"
}
}
}
```
### Python 代码中使用
```python
from akshare_mcp import mcp
# 启动服务器
mcp.run(transport="http", host="127.0.0.1", port=8000, path="/mcp")
```
## 可用工具
### 市场总貌
- `get_stock_sse_summary`: 上交所股票数据总貌
- `get_stock_szse_summary`: 深交所证券类别统计
- `get_stock_market_overview`: 中国股票市场总貌
### 个股信息
- `get_stock_info_xueqiu`: 雪球个股实时行情
- `get_stock_bid_ask`: 东方财富行情报价
### 历史数据
- `get_stock_a_hist`: A股历史K线数据
- `get_stock_a_realtime`: A股实时行情
- `get_stock_intraday_em`: 东方财富分时数据
### 行业分析
- `get_stock_szse_area_summary`: 深交所地区交易排行
- `get_stock_szse_sector_summary`: 深交所股票行业成交
- `get_stock_a_industry_comparison`: A股行业对比数据
### 其他数据
- `get_stock_a_dividend_yield`: A股股息率数据
- `get_stock_margin_data`: 融资融券数据
- `get_stock_sse_deal_daily`: 上交所每日股票情况
## 开发
### 安装开发依赖
```bash
pip install -e ".[dev]"
```
### 运行测试
```bash
pytest
```
### 代码格式化
```bash
black src/
ruff check src/
```
## 许可证
MIT License - 详见 [LICENSE](LICENSE) 文件
## 贡献
欢迎提交 Issue 和 Pull Request！
## 相关链接
- [AKShare 官方文档](https://akshare.akfamily.xyz/)
- [Model Context Protocol](https://modelcontextprotocol.io/)
- [FastMCP](https://github.com/jlowin/fastmcp)
Raw data
{
"_id": null,
"home_page": null,
"name": "a-stock-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "akshare, chinese-market, finance, mcp, stock",
"author": null,
"author_email": "Fanfei Gao <gfanfei@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/29/66/3bd3c653f3e001017e50da7a201841878411868580e2b8b8f838e764c6f9/a_stock_mcp-0.1.0.tar.gz",
"platform": null,
"description": "# AKShare MCP Server\n\nA Model Context Protocol (MCP) server for accessing Chinese stock market data via [AKShare](https://github.com/akfamily/akshare).\n\n## \u529f\u80fd\u7279\u6027\n\n- \ud83c\udfe2 **\u5e02\u573a\u603b\u89c8**: \u83b7\u53d6\u4e0a\u6d77\u3001\u6df1\u5733\u4ea4\u6613\u6240\u5e02\u573a\u7edf\u8ba1\u6570\u636e\n- \ud83d\udcc8 **\u4e2a\u80a1\u67e5\u8be2**: \u96ea\u7403\u3001\u4e1c\u65b9\u8d22\u5bcc\u7b49\u5e73\u53f0\u4e2a\u80a1\u5b9e\u65f6\u884c\u60c5\n- \ud83d\udcca **\u5386\u53f2\u6570\u636e**: A\u80a1\u5386\u53f2K\u7ebf\u3001\u5206\u65f6\u6570\u636e\n- \ud83d\udd0d **\u884c\u4e1a\u5206\u6790**: \u884c\u4e1a\u6210\u4ea4\u3001\u5730\u533a\u4ea4\u6613\u6392\u884c\n- \ud83d\udcb0 **\u878d\u8d44\u878d\u5238**: \u878d\u8d44\u878d\u5238\u7edf\u8ba1\u6570\u636e\n- \ud83d\udccb **\u884c\u60c5\u62a5\u4ef7**: \u4e94\u6863\u4e70\u5356\u76d8\u53e3\u6570\u636e\n\n## \u5b89\u88c5\n\n```bash\npip install akshare-mcp\n```\n\n## \u4f7f\u7528\u65b9\u6cd5\n\n### \u547d\u4ee4\u884c\u542f\u52a8\n\n```bash\nakshare-mcp\n```\n\n### \u4f5c\u4e3a MCP \u5ba2\u6237\u7aef\u4f7f\u7528\n\n\u5728\u652f\u6301 MCP \u7684\u5e94\u7528\uff08\u5982 Claude Desktop\uff09\u4e2d\u914d\u7f6e\uff1a\n\n```json\n{\n \"mcpServers\": {\n \"akshare\": {\n \"command\": \"akshare-mcp\"\n }\n }\n}\n```\n\n### Python \u4ee3\u7801\u4e2d\u4f7f\u7528\n\n```python\nfrom akshare_mcp import mcp\n\n# \u542f\u52a8\u670d\u52a1\u5668\nmcp.run(transport=\"http\", host=\"127.0.0.1\", port=8000, path=\"/mcp\")\n```\n\n## \u53ef\u7528\u5de5\u5177\n\n### \u5e02\u573a\u603b\u8c8c\n- `get_stock_sse_summary`: \u4e0a\u4ea4\u6240\u80a1\u7968\u6570\u636e\u603b\u8c8c\n- `get_stock_szse_summary`: \u6df1\u4ea4\u6240\u8bc1\u5238\u7c7b\u522b\u7edf\u8ba1\n- `get_stock_market_overview`: \u4e2d\u56fd\u80a1\u7968\u5e02\u573a\u603b\u8c8c\n\n### \u4e2a\u80a1\u4fe1\u606f\n- `get_stock_info_xueqiu`: \u96ea\u7403\u4e2a\u80a1\u5b9e\u65f6\u884c\u60c5\n- `get_stock_bid_ask`: \u4e1c\u65b9\u8d22\u5bcc\u884c\u60c5\u62a5\u4ef7\n\n### \u5386\u53f2\u6570\u636e\n- `get_stock_a_hist`: A\u80a1\u5386\u53f2K\u7ebf\u6570\u636e\n- `get_stock_a_realtime`: A\u80a1\u5b9e\u65f6\u884c\u60c5\n- `get_stock_intraday_em`: \u4e1c\u65b9\u8d22\u5bcc\u5206\u65f6\u6570\u636e\n\n### \u884c\u4e1a\u5206\u6790\n- `get_stock_szse_area_summary`: \u6df1\u4ea4\u6240\u5730\u533a\u4ea4\u6613\u6392\u884c\n- `get_stock_szse_sector_summary`: \u6df1\u4ea4\u6240\u80a1\u7968\u884c\u4e1a\u6210\u4ea4\n- `get_stock_a_industry_comparison`: A\u80a1\u884c\u4e1a\u5bf9\u6bd4\u6570\u636e\n\n### \u5176\u4ed6\u6570\u636e\n- `get_stock_a_dividend_yield`: A\u80a1\u80a1\u606f\u7387\u6570\u636e\n- `get_stock_margin_data`: \u878d\u8d44\u878d\u5238\u6570\u636e\n- `get_stock_sse_deal_daily`: \u4e0a\u4ea4\u6240\u6bcf\u65e5\u80a1\u7968\u60c5\u51b5\n\n## \u5f00\u53d1\n\n### \u5b89\u88c5\u5f00\u53d1\u4f9d\u8d56\n\n```bash\npip install -e \".[dev]\"\n```\n\n### \u8fd0\u884c\u6d4b\u8bd5\n\n```bash\npytest\n```\n\n### \u4ee3\u7801\u683c\u5f0f\u5316\n\n```bash\nblack src/\nruff check src/\n```\n\n## \u8bb8\u53ef\u8bc1\n\nMIT License - \u8be6\u89c1 [LICENSE](LICENSE) \u6587\u4ef6\n\n## \u8d21\u732e\n\n\u6b22\u8fce\u63d0\u4ea4 Issue \u548c Pull Request\uff01\n\n## \u76f8\u5173\u94fe\u63a5\n\n- [AKShare \u5b98\u65b9\u6587\u6863](https://akshare.akfamily.xyz/)\n- [Model Context Protocol](https://modelcontextprotocol.io/)\n- [FastMCP](https://github.com/jlowin/fastmcp)",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Stock MCP Server - A Model Context Protocol server for accessing Chinese stock market data via AKShare",
"version": "0.1.0",
"project_urls": {
"Bug Tracker": "https://github.com/iefnaf/akshare-mcp/issues",
"Documentation": "https://github.com/iefnaf/akshare-mcp#readme",
"Homepage": "https://github.com/iefnaf/akshare-mcp",
"Repository": "https://github.com/iefnaf/akshare-mcp.git"
},
"split_keywords": [
"akshare",
" chinese-market",
" finance",
" mcp",
" stock"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "623aa7b4c88f290a820ececcd349f5fa1fbef392f401267d86f8e50a888f7580",
"md5": "5c40934e8b3117919e44f619a18f9fa1",
"sha256": "e3c2ad2668f6280b5fc5bcbb843d5ed643fe24ad5bb9c83b3a17a276b457dae0"
},
"downloads": -1,
"filename": "a_stock_mcp-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5c40934e8b3117919e44f619a18f9fa1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 6123,
"upload_time": "2025-10-10T03:30:31",
"upload_time_iso_8601": "2025-10-10T03:30:31.345560Z",
"url": "https://files.pythonhosted.org/packages/62/3a/a7b4c88f290a820ececcd349f5fa1fbef392f401267d86f8e50a888f7580/a_stock_mcp-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "29663bd3c653f3e001017e50da7a201841878411868580e2b8b8f838e764c6f9",
"md5": "7f111c71d10f8e4bfef39780b3674bb5",
"sha256": "7704086d7370cecb4c6564392ad218490da2d861b1f95acd00b7f91f07a2e13a"
},
"downloads": -1,
"filename": "a_stock_mcp-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "7f111c71d10f8e4bfef39780b3674bb5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 186249,
"upload_time": "2025-10-10T03:30:33",
"upload_time_iso_8601": "2025-10-10T03:30:33.366373Z",
"url": "https://files.pythonhosted.org/packages/29/66/3bd3c653f3e001017e50da7a201841878411868580e2b8b8f838e764c6f9/a_stock_mcp-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-10 03:30:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "iefnaf",
"github_project": "akshare-mcp",
"github_not_found": true,
"lcname": "a-stock-mcp"
}
