使用说明
MCP服务器
一个MCP（模型上下文协议）服务器，它公开了使用公开市场数据源（例如，雅虎财经）检索实时和历史股票数据、统计数据和元数据的工具 yfinance).
此服务器旨在供MCP兼容客户端使用，如Claude Desktop、Cursor或自定义MCP客户端。它是 默认情况下不是REST API；工具是通过MCP协议而不是直接HTTP端点调用的。
概述
该服务器通过结构化MCP工具提供对股票市场信息的编程访问。每个工具代表一个函数，MCP客户端可以使用类型化参数调用该函数。
核心能力：
- 获取当前股票价格
- 检索最近的历史价格数据
- 获取公司元数据（部门、行业、市值等）
- 检索关键财务指标
- 支持通过类型化参数进行结构化输入
服务器在本地运行，并使用SSE或Streamable HTTP传输通过MCP进行通信。
建筑
组件
| 组件 | 角色 |
|---|---|
FastMCP |
注册工具和处理传输的核心MCP运行时 |
LoggerSingleton |
集中记录所有服务器活动 |
yfinance |
市场和公司信息数据提供商 |
requests |
如果需要，用于辅助HTTP请求 |
| MCP客户端 | 调用工具的外部应用程序（例如Claude Desktop） |
执行流程
- 服务器启动并初始化
FastMCP. - 库存工具在MCP运行时注册。
- MCP客户端使用SSE或HTTP传输进行连接。
- 客户端调用具有结构化参数的工具。
- 服务器执行相应的Python函数。
- 结果以结构化形式返回给客户。
安装
需求
- Python 3.10+
pip
安装依赖项
pip install fastmcp yfinance requests
示例文件夹结构
your_project/
├──src/
│ └── logger.py
│ ├── main.py
├──logs/
├──dockerfile
├──README.md
├──requirements.txt
运行服务器
启动MCP服务器：
python server.py
默认情况下，服务器运行在：
- http://127.0.0.1:8000
运输：苏格兰和南方能源公司
- 日志将写入：
- logs/mcp_server.log
