| Name | akshare-one-mcp JSON |
| Version |
0.3.3
JSON |
| download |
| home_page | None |
| Summary | MCP server that provides access to Chinese stock market data using akshare-one |
| upload_time | 2025-08-27 08:26:24 |
| 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
### Running Modes
The server supports two modes: stdio and streamable-http
**Command Line Arguments:**
- `--streamable-http`: Enable HTTP mode (default: stdio mode)
- `--host`: Host to bind to in HTTP mode (default: 0.0.0.0)
- `--port`: Port to listen on in HTTP mode (default: 8081)
**Note:** When using streamable-http mode, the MCP server will be available at `http://{host}:{port}/mcp`. For the default configuration, this would be `http://0.0.0.0:8081/mcp`.
### 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 [uv](<https://docs.astral.sh/uv/getting-started/installation/>) if you haven't already.
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 dependencies:
```bash
uv sync
```
3. 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/93/a7/cbdd0481d20d7b58b81d2e5cc3d96711037e55b8139b2761430a8f43e588/akshare_one_mcp-0.3.3.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### Running Modes\n\nThe server supports two modes: stdio and streamable-http\n\n**Command Line Arguments:**\n- `--streamable-http`: Enable HTTP mode (default: stdio mode)\n- `--host`: Host to bind to in HTTP mode (default: 0.0.0.0)\n- `--port`: Port to listen on in HTTP mode (default: 8081)\n\n**Note:** When using streamable-http mode, the MCP server will be available at `http://{host}:{port}/mcp`. For the default configuration, this would be `http://0.0.0.0:8081/mcp`.\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 [uv](<https://docs.astral.sh/uv/getting-started/installation/>) if you haven't already.\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 dependencies:\n\n ```bash\n uv sync\n ```\n\n3. 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.3",
"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": "1b98d518011b0ac0a9c7e42155353b748d022e08b130d07db18ed40a688e0e89",
"md5": "2e8d22572d56b09a38fa5ea01e74812f",
"sha256": "cc0cc682259a69fd697c4119656028de4fb8b941b24f742db4acf34ec5d88496"
},
"downloads": -1,
"filename": "akshare_one_mcp-0.3.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2e8d22572d56b09a38fa5ea01e74812f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 6411,
"upload_time": "2025-08-27T08:26:23",
"upload_time_iso_8601": "2025-08-27T08:26:23.079135Z",
"url": "https://files.pythonhosted.org/packages/1b/98/d518011b0ac0a9c7e42155353b748d022e08b130d07db18ed40a688e0e89/akshare_one_mcp-0.3.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "93a7cbdd0481d20d7b58b81d2e5cc3d96711037e55b8139b2761430a8f43e588",
"md5": "e8df100b7fa6b0be4dbfac35ecc18065",
"sha256": "7d9b371ef484240da2ba86dbfda8ef805338709e37857b55eb089b11223e5cb0"
},
"downloads": -1,
"filename": "akshare_one_mcp-0.3.3.tar.gz",
"has_sig": false,
"md5_digest": "e8df100b7fa6b0be4dbfac35ecc18065",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 4769,
"upload_time": "2025-08-27T08:26:24",
"upload_time_iso_8601": "2025-08-27T08:26:24.476682Z",
"url": "https://files.pythonhosted.org/packages/93/a7/cbdd0481d20d7b58b81d2e5cc3d96711037e55b8139b2761430a8f43e588/akshare_one_mcp-0.3.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-27 08:26:24",
"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"
}
