项目简介
AI股票追踪MCP服务器是AI股票追踪应用的核心组件,旨在通过标准化的Model Context Protocol (MCP) 接口,让外部AI助手能够无缝访问股票交易和分析功能。它将复杂的金融数据和分析能力封装成简单的工具,供LLM(大语言模型)客户端调用,实现智能化的股票查询、分析和决策辅助。
主要功能点
- 实时股票行情: 获取指定股票的最新价格、涨跌幅及公司信息。
- 历史数据查询: 提供股票在特定天数内的历史价格走势数据。
- 股票符号搜索: 根据公司名称或部分符号智能查找股票代码。
- 详细公司信息: 获取上市公司的详细元数据,如所属行业、板块等。
- 上市股票浏览: 支持分页浏览所有可用的上市股票列表。
- 系统健康监控: 检查API服务的健康状态和可用性。
- 随机股票推荐: 发现新的投资机会,随机获取一支上市股票信息。
- 详细历史价格: 提供指定日期范围内的更详细的历史价格数据。
安装步骤
- 克隆仓库: 将项目仓库克隆到本地计算机。
git clone https://github.com/emmanuelknafo/AiStockTradeApp.git cd AiStockTradeApp - 安装.NET SDK: 确保已安装.NET 9 SDK。
- 配置API Key: 编辑'appsettings.json'或通过环境变量配置Alpha Vantage和Twelve Data的API密钥,以便获取实时股票数据。
- 运行MCP服务器: 在项目根目录,使用命令行启动MCP服务器项目:
如果需要以HTTP模式运行(例如在Azure容器应用中),请使用:dotnet run --project AiStockTradeApp.McpServer
或设置环境变量 'UseHttp=true'。dotnet run --project AiStockTradeApp.McpServer -- --http
服务器配置(供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格式。
信息
分类
商业系统