What is Stock Info Mcp

stock_info_mcp is a stock data service based on FastMCP that provides various types of stock information, including historical data, fundamental information, and news updates.

Use cases

Use cases include developing financial dashboards, creating stock analysis tools, integrating stock data into trading platforms, and providing news updates for specific stocks.

How to use

To use stock_info_mcp, clone the repository, set up a virtual environment with Python 3.10 or higher, configure the MCP service using the provided JSON format, install dependencies, and start the service using the command line.

Key features

Key features include retrieving historical stock data, querying basic stock information, obtaining a list of risk warning stocks, viewing individual stock news, accessing financial news with pagination, and fetching main business information of stocks.

Where to use

stock_info_mcp can be used in financial analysis, stock market research, investment applications, and any domain requiring detailed stock information.

Stock Info Service

这是一个基于 FastMCP 的股票数据服务，提供了股票历史数据、基本面信息、新闻资讯等功能。

项目结构

stock-info/
├── src/
│   ├── config/           # 配置管理
│   │   └── settings.py
│   ├── core/            # 核心功能
│   │   └── exceptions.py
│   ├── models/          # 数据模型
│   │   └── stock.py
│   ├── repository/      # 数据访问层
│   │   └── stock_repository.py
│   ├── service/         # 业务逻辑层
│   │   └── stock_service.py
│   └── server.py        # 服务入口
├── pyproject.toml       # 项目配置
└── README.md           # 项目文档

功能特性

• 获取股票历史数据
• 查询股票基本信息
• 获取风险警示股票列表
• 查看个股新闻
• 获取财经新闻（支持分页）
• 获取股票主营业务信息
• …后续逐渐增加

MCP客户端配置步骤

• 1. 拉取代码
• 2. 使用uv建立虚拟环境 python 1.10+
• 3. 使用本地目录方式配置MCP服务

环境要求

• Python >= 3.10
• 依赖包：
  • fastmcp
  • akshare
  • pandas
  • pydantic
  • pydantic-settings

安装部署

1. 创建虚拟环境:

python -m venv .venv

2. 激活虚拟环境:

# Windows
.venv\Scripts\activate
# Linux/macOS
source .venv/bin/activate

3. 安装依赖:

pip install -e .

启动服务

# 使用默认配置启动
python src/server.py

# 使用 HTTP 传输协议启动
python src/server.py --transport http --port 8080

# 设置日志级别
python src/server.py --log-level debug

工具说明

1. get_stock_info: 获取指定股票代码、指定日期范围的股价信息
2. get_stock_price_monthly: 获取指定股票最近30天的股价信息
3. stock_individual_basic_info: 获取指定股票的基本信息
4. risk_stocks: 获取风险警示板股票列表
5. stock_merito_data: 获取指定股票的主营业务信息
6. get_stock_news: 获取指定股票的新闻资讯
7. get_finance_news: 获取财经精选新闻（支持分页）

项目特点

1. 模块化设计：采用清晰的分层架构，便于维护和扩展
2. 统一异常处理：使用自定义异常体系，提供友好的错误提示
3. 配置集中管理：使用 pydantic-settings 进行配置管理
4. 类型提示：全面使用 Python 类型注解，提高代码可读性
5. 数据验证：使用 Pydantic 模型进行数据验证和序列化

开发规范

1. 使用 ruff 进行代码格式化和 lint
2. 遵循 PEP 8 编码规范
3. 保持完整的类型注解
4. 编写清晰的文档字符串

错误处理

服务统一返回以下格式的错误信息：

{
  "error": "错误代码",
  "message": "错误描述",
  "details": {
    "额外信息": "值"
  }
}

主要错误代码

• STOCK_NOT_FOUND: 股票代码不存在
• INVALID_DATE_FORMAT: 日期格式错误
• DATA_FETCH_ERROR: 数据获取失败
• INVALID_PAGINATION: 分页参数错误
• SYSTEM_ERROR: 系统内部错误