股票信息服务中心

这是一个基于 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 3.10+ 版本
3. 使用本地目录方式配置 MCP 服务

以下为示例配置：

{  
  "mcpServers": {  
     "stock-info": {  
      "isActive": true,  
      "command": "uv",  
      "args": [  
        "--directory",  
        "\\path\\to\\sock_info\\src",  
        "run",  
        "server.py"  
      ]  
    }  
  }  
}  

环境要求

• 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 -r requirements.txt  

启动服务

1. 使用默认配置启动：

python src/server.py  

2. 使用 HTTP 协议启动：

uvicorn stock_info.app:app --reload  

工具说明

以下是服务提供的一些主要功能及其用途：

• 获取股票历史数据：get_stock_history_data()
  返回指定股票的历史股价数据。

• 查询股票基本信息：get_stock_info()
  返回股票的基本信息，如公司名称、行业等。

• 风险警示股票列表：get_risk_warning_stocks()
  获取当前存在风险警示的股票列表。

• 查看个股新闻：get_stock_news()
  获取指定股票的相关新闻资讯。

• 财经新闻（支持分页）：get_financial_news()
  返回最新的财经新闻，并支持分页查询。

• 获取股票主营业务信息：get_main_business_info()
  返回股票的主营业务详情。

项目特点

1. 模块化设计：代码结构清晰，便于维护和扩展。
2. 统一异常处理：通过 exceptions.py 实现了统一的错误捕获与处理机制。
3. 数据访问层：使用 repository 层实现数据操作的封装，提升代码复用性。
4. 依赖管理：通过 pyproject.toml 和 requirements.txt 管理项目依赖，确保环境一致性。

开发规范

1. 遵循 PEP 8 编码规范，保持代码风格统一。
2. 使用黑体（black）进行代码格式化，确保代码可读性。
3. 使用 ruff 工具进行代码检查和 linting，保证代码质量。
4. 在提交代码前，请先运行测试用例并确保所有检查通过。

错误处理

服务在遇到错误时会返回如下的 JSON 格式响应：

{  
  "error": {  
    "code": " ErrorCode ",  
    "message": " Error Message "  
  }  
}  

以下是主要的错误代码和对应的含义：

• 400: 参数错误（Bad Request）
• 401: 未授权访问（Unauthorized）
• 403: 禁止访问（Forbidden）
• 404: 资源未找到（Not Found）
• 500: 内部服务器错误（Internal Server Error）

注意事项

1. 所有 API 接口均支持 JSON 格式返回，部分接口还支持分页查询。
2. 使用前请仔细阅读接口文档，确保正确使用参数和返回值。
3. 服务运行时可能会产生一定开销，请根据实际情况配置资源限制。