Finance_mcp_server

Finance_mcp-server

一个通过 Yahoo Finance 向大模型提供实时金融数据的模型上下文协议（MCP）服务。

本项目创建了一个 MCP 服务，允许 Claude 等 AI 模型通过 Yahoo Finance API 访问实时股票和金融数据。该服务实现了模型上下文协议标准，可与 Claude Desktop、Cursor、Winds AI 等各种 MCP 客户端无缝集成。

🚀 功能

• 实时股票价格查询：获取任何上市公司的当前股价
• 历史数据分析：检索自定义时间段内的股票表现
• 公司信息：获取详细的公司简介和财务指标
• 股票比较：根据各种指标比较多只股票
• 股票搜索：按公司名称或关键词查找相关股票
• 资源访问：使用结构化 URI 方案访问金融数据

📋 要求

• Python 3.9 或更高版本
• yfinance 包
• mcp 包

💻 安装

1. 克隆此存储库：

   git clone https://github.com/dino65-dev/Finance_mcp-server.git
   

2. 创建虚拟环境：

   python -m venv venv
   On Windows: venv\Scripts\activate
   

创建虚拟环境（推荐），以便更快地创建：

pip install uv
uv venv
On Windows: venv\Scripts\activate

3. 安装依赖项：

   pip install -r requirements.txt
   

🔧 使用方法

运行服务

运行以下命令启动服务：

python yfinance_mcp_server.py

该服务将作为通过 MCP 协议通信的 stdin/stdout 进程运行。

与 MCP 客户端集成

Claude Desktop

1. 打开 Claude Desktop
2. 前往设置
3. 添加 MCP 配置：

   {
     "mcpServers": {
       "yfinance": {
         "command": "python",
         "args": [
           "/absolute/path/to/yfinance_mcp_server.py"
         ]
       }
     }
   }
   

4. 保存并重启 Claude Desktop

Cursor

1. 打开 Cursor 并进入设置
2. 前往 MCP 部分
3. 使用以下配置添加新的全局 MCP 服务：

   {
     "yfinance": {
       "command": "python",
       "args": [
         "/absolute/path/to/yfinance_mcp_server.py"
       ]
     }
   }
   

4. 开启新聊天以使用金融工具

📊 可用工具

该服务提供以下工具：

1. get_stock_price：获取当前股价

   Example: Get the current price of Apple stock
   

2. get_historical_data：检索历史价格数据

   Example: Get the stock history for TSLA over the past 3 months
   

3. get_stock_metric：获取特定财务指标

   Example: What is Amazon's market capitalization?
   

4. compare_stocks：按指标比较多只股票

   Example: Compare the P/E ratios of Google, Microsoft, and Apple
   

5. search_stocks：按名称或关键词查找股票

   Example: Find stocks related to artificial intelligence
   

🔍 资源 URI

通过资源 URI 直接访问股票信息：

• finance://SYMBOL/info - 获取股票的基本信息

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

🙏 致谢

• Yahoo Finance 提供金融数据
• yfinance 提供 Python API
• Anthropic 提供 MCP 规范

📞 参与贡献

欢迎贡献！请随时提交 Pull Request。