项目简介

AI股票追踪MCP服务器是AI股票追踪应用的核心组件,旨在通过标准化的Model Context Protocol (MCP) 接口,让外部AI助手能够无缝访问股票交易和分析功能。它将复杂的金融数据和分析能力封装成简单的工具,供LLM(大语言模型)客户端调用,实现智能化的股票查询、分析和决策辅助。

主要功能点

  • 实时股票行情: 获取指定股票的最新价格、涨跌幅及公司信息。
  • 历史数据查询: 提供股票在特定天数内的历史价格走势数据。
  • 股票符号搜索: 根据公司名称或部分符号智能查找股票代码。
  • 详细公司信息: 获取上市公司的详细元数据,如所属行业、板块等。
  • 上市股票浏览: 支持分页浏览所有可用的上市股票列表。
  • 系统健康监控: 检查API服务的健康状态和可用性。
  • 随机股票推荐: 发现新的投资机会,随机获取一支上市股票信息。
  • 详细历史价格: 提供指定日期范围内的更详细的历史价格数据。

安装步骤

  1. 克隆仓库: 将项目仓库克隆到本地计算机。
    git clone https://github.com/emmanuelknafo/AiStockTradeApp.git
    cd AiStockTradeApp
  2. 安装.NET SDK: 确保已安装.NET 9 SDK。
  3. 配置API Key: 编辑'appsettings.json'或通过环境变量配置Alpha Vantage和Twelve Data的API密钥,以便获取实时股票数据。
  4. 运行MCP服务器: 在项目根目录,使用命令行启动MCP服务器项目:
    dotnet run --project AiStockTradeApp.McpServer
    如果需要以HTTP模式运行(例如在Azure容器应用中),请使用:
    dotnet run --project AiStockTradeApp.McpServer -- --http
    或设置环境变量 'UseHttp=true'。

服务器配置(供MCP客户端参考)

MCP客户端连接AI股票追踪MCP服务器时,需要配置以下信息:

  • 服务器名称: 'AiStockTradeApp.McpServer' (或其他自定义名称)
  • 连接类型: 'stdio' (通过标准输入输出进行通信) 或 'http' (通过HTTP协议通信)
  • 启动命令 (command): 'dotnet' (用于运行.NET应用程序)
  • 启动参数 (args): 'run --project AiStockTradeApp.McpServer' (指定要运行的MCP服务器项目)
  • 环境变量 (env): 可以选择配置'STOCK_API_BASE_URL',指向提供股票API的后端服务地址,例如'http://localhost:5000'。

基本使用方法

MCP服务器启动后,LLM客户端(如Claude、ChatGPT、Cursor IDE等)可以连接并发现其提供的工具。例如,LLM客户端可以发起一个请求来获取苹果公司的股票报价:

  • 通过STDIO模式: 客户端向服务器的标准输入发送JSON-RPC请求。
  • 通过HTTP模式: 客户端向服务器的'/mcp' HTTP端点发送POST请求,请求体为JSON-RPC格式。

信息

分类

商业系统