使用说明

项目简介

Stock MCP Server 是一个基于 Spring Boot 和 Spring AI 框架构建的 MCP 服务器，旨在为大型语言模型（LLM）应用提供股票市场相关的数据查询能力。它通过 Tool 机制将股票数据查询功能暴露给 LLM 客户端，使得 LLM 能够便捷地获取股票实时交易信息、公司基本信息以及分时价格数据，从而更好地理解和处理用户关于股票市场的问题。

主要功能点

股票实时交易信息查询: 根据股票代码查询股票的最新交易数据，例如当前价格、涨跌幅、成交量等。
公司详细信息查询: 根据股票代码查询上市公司的基本信息，包括公司名称、上市日期、经营范围等。
股票分时价格查询: 根据股票代码和日期范围查询股票在特定时间段内的分时价格数据。
获取当前时间: 提供获取服务器当前日期的工具，方便 LLM 进行时间相关的推理。

安装步骤

环境准备: 确保已安装 JDK 21 或更高版本，并配置好 Maven 3.6.0 或更高版本的环境。
下载代码: 从 GitHub 仓库 https://github.com/sungongtai/stock-mcp 克隆代码到本地。
编译项目: 在项目根目录下打开命令行终端，执行 'mvn package' 命令编译项目。编译成功后，将在 'target' 目录下生成 'stock-mcp-0.0.1-SNAPSHOT.jar' 文件。

服务器配置

MCP 客户端（例如 Cursor 编辑器）需要配置 MCP 服务器的启动命令才能连接并使用其提供的功能。以下是 'mcp.json' 配置文件示例，请根据实际情况进行修改：

{
  "mcpServers": {
    "stockServer": {
      "command": "/path/to/your/jdk-21/bin/java",  //  请替换为本地 JDK 21 的 java.exe 或 java 可执行文件路径
      "args": ["-jar", "/path/to/stock-mcp-0.0.1-SNAPSHOT.jar"] // 请替换为实际 jar 包的路径，通常为项目 target 目录下的 stock-mcp-0.0.1-SNAPSHOT.jar
    }
  }
}

配置参数说明:

'command': 必填。指向 JDK 21 或更高版本安装目录下的 'java.exe' (Windows) 或 'java' (Linux/macOS) 可执行文件的完整路径。这是运行 Java 程序的命令。
'args': 必填。一个字符串数组，包含启动 MCP 服务器所需的参数。
- '"-jar"': 固定参数，表示运行可执行的 JAR 文件。
- '"/path/to/stock-mcp-0.0.1-SNAPSHOT.jar"': 请替换为 步骤3编译项目后 生成的 'stock-mcp-0.0.1-SNAPSHOT.jar' 文件在您本地文件系统中的 绝对路径。

配置方法 (以 Cursor 为例):

打开 Cursor 编辑器。
点击菜单 'File -> Preferences -> Cursor Settings -> MCP'。
点击 'Add new' 添加新的 MCP 服务器配置。
将上述 'mcp.json' 内容复制到配置框中。
务必根据注释修改 'command' 和 'args' 字段中的路径，确保路径指向您本地正确的 JDK 21 'java' 可执行文件和 'stock-mcp-0.0.1-SNAPSHOT.jar' 文件。

基本使用方法

配置完成后，在 Cursor 编辑器中，您可以向大模型提出关于股票市场的问题。MCP 服务器将作为工具，为大模型提供所需的股票数据。

例如，您可以尝试以下问题：

"请问 000001 股票的实时交易信息是什么？"
"查询一下平安银行（000001）的详细公司信息。"
"000001 股票过去一周的分时价格走势如何？"
"今天几号了？" （用于测试 'getCurrentTime' 工具）

大模型将会调用 Stock MCP Server 提供的工具来获取数据，并基于获取的数据回答您的问题。

注意:

本 MCP 服务器依赖于外部股票数据 API (mairui.club, mairuiapi.com)。请确保网络连接正常，并且 API 服务可用。
示例中使用的股票数据 API License ( '3B481864-FFE6-490F-85E0-767439447247' 和 'b997d4403688d5e66a') 可能存在使用限制，请根据实际情况和 API 提供商的政策进行调整。

关键词