akshare-mcp-ikouhaha

# Akshare MCP Server [English](#english) | [中文](#中文) ## 中文 ### 简介 Akshare MCP Server 是一个基于 [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 的服务器，提供中国金融数据接口。通过集成 [akshare](https://github.com/akfamily/akshare) 库，为 Claude 等 AI 助手提供实时和历史的股票、期货、基金等金融数据。 ### 功能特性 - 📈 **股票数据**：支持 A股股票的分钟级（5分钟、15分钟、30分钟、60分钟）和日线数据 - 🥇 **期货数据**：支持期货合约的分钟级和日线数据，包括黄金、白银等主力合约 - 💰 **黄金数据**：专门的黄金期货和现货数据接口 - 🔍 **股票搜索**：根据股票名称或代码搜索股票信息 - 📊 **市场概览**：提供 A股市场的整体概况和主要指数 - 🔄 **实时数据**：支持最新的交易数据和历史数据查询 ### 安装 #### 使用 uvx（推荐） ```bash uvx akshare-mcp-ikouhaha ``` #### 使用 pip ```bash pip install akshare-mcp-ikouhaha ``` #### 从源码安装 ```bash git clone https://github.com/your-username/akshare-mcp.git cd akshare-mcp pip install -e . ``` ### 配置 在你的 MCP 客户端配置文件中添加服务器配置： ```json { "mcpServers": { "akshare": { "command": "akshare-mcp-ikouhaha" } } } ``` ### 使用示例 #### 获取股票数据 ```python # 获取平安银行（000001）的日线数据 get_stock_data({"symbol": "000001", "period": "daily"}) # 获取5分钟数据 get_stock_data({"symbol": "000001", "period": "5min", "adjust": "qfq"}) ``` #### 获取期货数据 ```python # 获取黄金主力合约数据 get_futures_data({"symbol": "AU0", "period": "daily"}) # 获取5分钟期货数据 get_futures_data({"symbol": "AU0", "period": "5min"}) ``` #### 搜索股票 ```python # 搜索包含"平安"的股票 search_stock({"keyword": "平安"}) # 根据股票代码搜索 search_stock({"keyword": "000001"}) ``` ### API 文档 #### 工具列表 1. **get_stock_data** - 获取股票数据 - `symbol` (必需): 股票代码，如 "000001" - `period` (可选): 数据周期 ["5min", "15min", "30min", "60min", "daily", "weekly", "monthly"]，默认 "daily" - `adjust` (可选): 复权类型 ["qfq", "hfq", ""]，默认 "qfq" 2. **get_futures_data** - 获取期货数据 - `symbol` (必需): 期货代码，如 "AU0"（黄金主力） - `period` (可选): 数据周期 ["5min", "15min", "30min", "60min", "daily"]，默认 "daily" 3. **get_gold_data** - 获取黄金数据 - `data_type` (可选): 数据类型 ["futures", "spot", "futures_5min"]，默认 "futures" - `period` (可选): 数据周期，默认 "daily" 4. **get_market_overview** - 获取市场概览 - `market` (可选): 市场类型 ["a_share", "us", "hk"]，默认 "a_share" 5. *…