该仓库包含一个基于Model Context Protocol (MCP) 构建的服务器实现，专注于提供股票市场相关的数据和功能。它允许兼容MCP的LLM客户端通过标准化的协议访问实时的股票信息。

项目简介

“股票市场MCP服务器”是一个后端应用，遵循MCP规范，为LLM客户端提供上下文和工具能力。它能够连接到外部股票数据API，获取股票价格等信息，并将其作为可由LLM调用的“工具”暴露出来。

主要功能点

• 提供股票价格工具: 集成外部金融数据API（如Alpha Vantage），提供一个可通过MCP调用的工具，用于查询指定股票的当前价格。
• 遵循MCP协议: 实现MCP标准，支持JSON-RPC通信，确保与标准MCP客户端的兼容性。
• 会话管理: 支持管理与LLM客户端的连接和会话状态（由FastMCP框架提供）。

安装步骤

1. 克隆仓库:

   git clone https://github.com/pedrorfdez/stock-market-mcp-server.git
   cd stock-market-mcp-server
   

2. 安装uv和设置Python环境: 如果你还没有安装'uv'，请先安装它。然后创建并激活项目虚拟环境：

   # 安装 uv (如果尚未安装)
   # pip install uv
   
   # 创建并激活虚拟环境
   uv venv
   source .venv/bin/activate  # Windows 用户请使用: .venv\Scripts\activate
   

3. 安装依赖:

   uv pip install -e .
   

4. 配置API密钥: 创建一个 '.env' 文件在项目根目录下，并添加你的Alpha Vantage API密钥：

   ALPHAVANTAGE_API_KEY=你的API密钥
   

   请访问 Alpha Vantage 网站获取API密钥。

服务器配置

MCP客户端连接此服务器时，需要配置服务器的启动信息。根据此仓库的代码和运行方式，客户端通常需要配置以下信息：

• 服务器名称 (name): StockMarketServer
• 启动命令 (command): uv
• 启动参数 (args): run stock_market.py

这些配置信息是给MCP客户端使用的，用于让客户端知道如何启动和连接这个MCP服务器进程。

基本使用方法

1. 确保已完成安装和API密钥配置步骤。
2. 在项目根目录，激活你的Python虚拟环境（如果尚未激活）。
3. 运行以下命令启动MCP服务器：

   uv run stock_market.py
   

   服务器启动后，它将监听来自MCP客户端的连接和请求。
4. 使用兼容MCP的LLM客户端，根据上述“服务器配置”信息连接到此服务器。连接成功后，LLM即可通过协议发现并调用服务器提供的股票查询工具。