| Name | akshare-one-mcp JSON |
| Version |
0.3.0
JSON |
| download |
| home_page | None |
| Summary | MCP server that provides access to Chinese stock market data using akshare-one |
| upload_time | 2025-08-02 12:00:56 |
| maintainer | None |
| docs_url | None |
| author | zwldarren |
| requires_python | >=3.12 |
| license | MIT |
| keywords |
akshare
stock
mcp
mcp-server
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# AKShare One MCP Server
<div align="center">
<a href="README.md">English</a> |
<a href="README_zh.md">中文</a>
</div>
[](https://smithery.ai/server/@zwldarren/akshare-one-mcp)
An MCP server based on [akshare-one](https://github.com/zwldarren/akshare-one), providing interfaces for China stock market data. It offers a set of tools for retrieving financial information including historical stock data, real-time data, news data, financial statements, etc.
<a href="https://glama.ai/mcp/servers/@zwldarren/akshare-one-mcp">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@zwldarren/akshare-one-mcp/badge" alt="akshare-one-mcp MCP server" />
</a>
## Tools
### `get_hist_data`
Get historical stock market data. 'eastmoney_direct' supports all A, B, H shares.
- symbol (string): Stock code (e.g. '000001')
- interval (string): Time interval ('minute','hour','day','week','month','year') (default: 'day')
- interval_multiplier (number, optional): Interval multiplier (default: 1)
- start_date (string, optional): Start date in YYYY-MM-DD format (default: '1970-01-01')
- end_date (string, optional): End date in YYYY-MM-DD format (default: '2030-12-31')
- adjust (string, optional): Adjustment type ('none', 'qfq', 'hfq') (default: 'none')
- source (string, optional): Data source ('eastmoney', 'eastmoney_direct', 'sina') (default: 'eastmoney')
- indicators_list (list, optional): Technical indicators to add (e.g. ['SMA', 'EMA', 'RSI', 'MACD', 'BOLL', 'STOCH', 'ATR', 'CCI', 'ADX', 'WILLR', 'AD', 'ADOSC', 'OBV', 'MOM', 'SAR', 'TSF', 'APO', 'AROON', 'AROONOSC', 'BOP', 'CMO', 'DX', 'MFI', 'MINUS_DI', 'MINUS_DM', 'PLUS_DI', 'PLUS_DM', 'PPO', 'ROC', 'ROCP', 'ROCR', 'ROCR100', 'TRIX', 'ULTOSC'])
- recent_n (number, optional): Number of most recent records to return (default: 100)
### `get_realtime_data`
Get real-time stock market data. 'eastmoney_direct' supports all A, B, H shares.
- symbol (string, optional): Stock code
- source (string, optional): Data source ('xueqiu', 'eastmoney', 'eastmoney_direct') (default: 'eastmoney_direct')
### `get_news_data`
Get stock-related news data.
- symbol (string): Stock code
- recent_n (number, optional): Number of most recent records to return (default: 10)
### `get_balance_sheet`
Get company balance sheet data.
- symbol (string): Stock code
- recent_n (number, optional): Number of most recent records to return (default: 10)
### `get_income_statement`
Get company income statement data.
- symbol (string): Stock code
- recent_n (number, optional): Number of most recent records to return (default: 10)
### `get_cash_flow`
Get company cash flow statement data.
- symbol (string): Stock code
- source (string, optional): Data source (default: 'sina')
- recent_n (number, optional): Number of most recent records to return (default: 10)
### `get_inner_trade_data`
Get company insider trading data.
- symbol (string): Stock code
### `get_financial_metrics`
Get key financial metrics from the three major financial statements.
- symbol (string): Stock code
- recent_n (number, optional): Number of most recent records to return (default: 10)
### `get_time_info`
Get current time with ISO format, timestamp, and the last trading day.
## Usage Instructions
### Installing via Smithery
To install akshare-one-mcp for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@zwldarren/akshare-one-mcp):
```bash
npx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude
```
### Installing via `uv`
Install directly from PyPI using uv:
```bash
uv pip install akshare-one-mcp
```
Add the following configuration:
```json
"mcpServers": {
"akshare-one-mcp": {
"command": "uvx",
"args": ["akshare-one-mcp"]
}
}
```
### Installing via local source code
1. Clone this repository:
```bash
git clone https://github.com/zwldarren/akshare-one-mcp.git
cd akshare-one-mcp
```
2. Install [uv](<https://docs.astral.sh/uv/getting-started/installation/>) if you haven't already.
3. Install dependencies:
```bash
uv sync
```
4. Add the following configuration:
```json
"mcpServers": {
"akshare-one-mcp": {
"command": "uv",
"args": [
"--directory",
"/path/to/akshare-one-mcp",
"run",
"akshare-one-mcp"
]
}
}
```
Raw data
{
"_id": null,
"home_page": null,
"name": "akshare-one-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "akshare, stock, mcp, mcp-server",
"author": "zwldarren",
"author_email": "zwldarren <zwldarren@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/39/7f/47ebc2d48e2c40a82032c730ad7ea88f8e90df9f5e405c2b22d6044d7023/akshare_one_mcp-0.3.0.tar.gz",
"platform": null,
"description": "# AKShare One MCP Server\n\n<div align=\"center\">\n <a href=\"README.md\">English</a> | \n <a href=\"README_zh.md\">\u4e2d\u6587</a>\n</div>\n\n[](https://smithery.ai/server/@zwldarren/akshare-one-mcp)\n\nAn MCP server based on [akshare-one](https://github.com/zwldarren/akshare-one), providing interfaces for China stock market data. It offers a set of tools for retrieving financial information including historical stock data, real-time data, news data, financial statements, etc.\n\n<a href=\"https://glama.ai/mcp/servers/@zwldarren/akshare-one-mcp\">\n <img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@zwldarren/akshare-one-mcp/badge\" alt=\"akshare-one-mcp MCP server\" />\n</a>\n\n## Tools\n\n### `get_hist_data`\n\nGet historical stock market data. 'eastmoney_direct' supports all A, B, H shares.\n\n- symbol (string): Stock code (e.g. '000001')\n- interval (string): Time interval ('minute','hour','day','week','month','year') (default: 'day')\n- interval_multiplier (number, optional): Interval multiplier (default: 1)\n- start_date (string, optional): Start date in YYYY-MM-DD format (default: '1970-01-01')\n- end_date (string, optional): End date in YYYY-MM-DD format (default: '2030-12-31')\n- adjust (string, optional): Adjustment type ('none', 'qfq', 'hfq') (default: 'none')\n- source (string, optional): Data source ('eastmoney', 'eastmoney_direct', 'sina') (default: 'eastmoney')\n- indicators_list (list, optional): Technical indicators to add (e.g. ['SMA', 'EMA', 'RSI', 'MACD', 'BOLL', 'STOCH', 'ATR', 'CCI', 'ADX', 'WILLR', 'AD', 'ADOSC', 'OBV', 'MOM', 'SAR', 'TSF', 'APO', 'AROON', 'AROONOSC', 'BOP', 'CMO', 'DX', 'MFI', 'MINUS_DI', 'MINUS_DM', 'PLUS_DI', 'PLUS_DM', 'PPO', 'ROC', 'ROCP', 'ROCR', 'ROCR100', 'TRIX', 'ULTOSC'])\n- recent_n (number, optional): Number of most recent records to return (default: 100)\n\n### `get_realtime_data`\n\nGet real-time stock market data. 'eastmoney_direct' supports all A, B, H shares.\n\n- symbol (string, optional): Stock code\n- source (string, optional): Data source ('xueqiu', 'eastmoney', 'eastmoney_direct') (default: 'eastmoney_direct')\n\n### `get_news_data`\n\nGet stock-related news data.\n\n- symbol (string): Stock code\n- recent_n (number, optional): Number of most recent records to return (default: 10)\n\n### `get_balance_sheet`\n\nGet company balance sheet data.\n\n- symbol (string): Stock code\n- recent_n (number, optional): Number of most recent records to return (default: 10)\n\n### `get_income_statement`\n\nGet company income statement data.\n\n- symbol (string): Stock code\n- recent_n (number, optional): Number of most recent records to return (default: 10)\n\n### `get_cash_flow`\n\nGet company cash flow statement data.\n\n- symbol (string): Stock code\n- source (string, optional): Data source (default: 'sina')\n- recent_n (number, optional): Number of most recent records to return (default: 10)\n\n### `get_inner_trade_data`\n\nGet company insider trading data.\n\n- symbol (string): Stock code\n\n### `get_financial_metrics`\n\nGet key financial metrics from the three major financial statements.\n\n- symbol (string): Stock code\n- recent_n (number, optional): Number of most recent records to return (default: 10)\n\n### `get_time_info`\n\nGet current time with ISO format, timestamp, and the last trading day.\n\n## Usage Instructions\n\n### Installing via Smithery\n\nTo install akshare-one-mcp for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@zwldarren/akshare-one-mcp):\n\n```bash\nnpx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude\n```\n\n### Installing via `uv`\n\nInstall directly from PyPI using uv:\n\n```bash\nuv pip install akshare-one-mcp\n```\n\nAdd the following configuration:\n\n```json\n\"mcpServers\": {\n \"akshare-one-mcp\": {\n \"command\": \"uvx\",\n \"args\": [\"akshare-one-mcp\"]\n }\n}\n```\n\n### Installing via local source code\n\n1. Clone this repository:\n\n ```bash\n git clone https://github.com/zwldarren/akshare-one-mcp.git\n cd akshare-one-mcp\n ```\n\n2. Install [uv](<https://docs.astral.sh/uv/getting-started/installation/>) if you haven't already.\n\n3. Install dependencies:\n\n ```bash\n uv sync\n ```\n\n4. Add the following configuration:\n\n ```json\n \"mcpServers\": {\n \"akshare-one-mcp\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"/path/to/akshare-one-mcp\",\n \"run\",\n \"akshare-one-mcp\"\n ]\n }\n }\n ```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "MCP server that provides access to Chinese stock market data using akshare-one",
"version": "0.3.0",
"project_urls": {
"Homepage": "https://github.com/zwldarren/akshare-one-mcp",
"Repository": "https://github.com/zwldarren/akshare-one-mcp.git"
},
"split_keywords": [
"akshare",
" stock",
" mcp",
" mcp-server"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "9d174ac0f0ffee683025c79d120c281cc5c464114c674f9621f48336e52c852b",
"md5": "8eb6028a1de55beebc56cd55ca476967",
"sha256": "a1f64b95c1c9ade9d2146f3af66cddb2f2a36a1d5077d10b96550e14bd0377af"
},
"downloads": -1,
"filename": "akshare_one_mcp-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8eb6028a1de55beebc56cd55ca476967",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 5739,
"upload_time": "2025-08-02T12:00:54",
"upload_time_iso_8601": "2025-08-02T12:00:54.860813Z",
"url": "https://files.pythonhosted.org/packages/9d/17/4ac0f0ffee683025c79d120c281cc5c464114c674f9621f48336e52c852b/akshare_one_mcp-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "397f47ebc2d48e2c40a82032c730ad7ea88f8e90df9f5e405c2b22d6044d7023",
"md5": "4bea421b821b21539f81942dba668fe9",
"sha256": "22ef799bc2aff106aa6b66654cc773c0d60d0ff0ffdf5bbdedcefbc3340b9798"
},
"downloads": -1,
"filename": "akshare_one_mcp-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "4bea421b821b21539f81942dba668fe9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 4139,
"upload_time": "2025-08-02T12:00:56",
"upload_time_iso_8601": "2025-08-02T12:00:56.261256Z",
"url": "https://files.pythonhosted.org/packages/39/7f/47ebc2d48e2c40a82032c730ad7ea88f8e90df9f5e405c2b22d6044d7023/akshare_one_mcp-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-02 12:00:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "zwldarren",
"github_project": "akshare-one-mcp",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "akshare-one-mcp"
}
