使用说明

项目简介

本项目 'stock_price_4_fun' 是一个基于 Model Context Protocol (MCP) 实现的股票分析服务器。它旨在为大型语言模型 (LLM) 客户端提供实用的股票市场分析工具，并支持客户端通过标准化的 MCP 协议进行调用，从而增强 LLM 在金融分析领域的应用能力。

主要功能点

投资回报期 (Payback Time) 分析工具: 计算股票的投资回收期，帮助评估股票的投资价值。
技术指标工具: 提供 MACD、价格与移动平均线 (Price vs MA)、大交易日预警 (Big Day Warning) 等技术指标分析工具，辅助 LLM 进行股票趋势判断。
数据访问能力: 通过 MCP 协议，LLM 客户端可以请求服务器执行股票数据分析，获取分析结果。
FastAPI MCP 集成: 使用 'fastapi-mcp' 库简化 MCP 服务器的开发和部署。

安装步骤

克隆仓库:

git clone https://github.com/mrzaizai2k/stock_price_4_fun
cd stock_price_4_fun

安装依赖:
```
pip install -r setup_win.txt
```
请确保已安装 Python 环境。如果您的环境是 Linux，可能需要参考仓库 README 中的 selenium for linux 安装指南。

服务器配置

为了让 MCP 客户端（例如 Claude Desktop）连接到此服务器，您需要在客户端的 MCP 服务器配置中添加以下 JSON 配置。请注意，以下配置信息仅为示例，您需要根据实际情况调整 'command' 和 'args' 字段，但通常情况下，无需修改，直接复制粘贴即可使用。

{
  "mcpServers": {
    "paybacktime": {
      "command": "mcp-proxy",
      "args": ["http://127.0.0.1:8668/mcp"]
    }
  }
}

配置参数说明 (无需修改，提供给开发者参考):

'"paybacktime"': 服务器名称，客户端用此名称引用该服务器。
'"command": "mcp-proxy"': 启动 MCP 代理的命令。'mcp-proxy' 是 '@modelcontextprotocol/server-filesystem' 包提供的工具，用于将 HTTP API 转换为 MCP 协议。
'"args": ["http://127.0.0.1:8668/mcp"]': 'mcp-proxy' 命令的参数，指定了 FastAPI MCP 服务器的 HTTP 地址。'http://127.0.0.1:8668/mcp' 是本项目 MCP 服务器默认的访问地址。

MCP 客户端配置位置 (以 Claude Desktop 为例):

请参考仓库 README 中 'MCP server' 章节的 'Claude Desktop' 配置说明，通常配置文件路径类似于 'C:\Users\Admin\AppData\Roaming\Claude\claude_desktop_config.json'。

基本使用方法

启动服务器: 在仓库根目录下，运行以下命令启动 MCP 服务器：
```
python src/mcp_server.py
```
或者，如果您使用 Linux 系统，可以使用 'make bot' 命令。
配置 MCP 客户端: 将上文提供的 JSON 配置添加到您的 MCP 客户端配置中，确保客户端能够识别并连接到本服务器。
通过 MCP 客户端调用工具: 使用支持 MCP 协议的 LLM 客户端，即可向本服务器发送 MCP 请求，调用服务器提供的股票分析工具。具体的调用方法和参数，请参考 MCP 客户端的文档和本仓库的代码。例如，您可以指示 Claude 调用名为 'paybacktime' 的服务器，并传递股票代码等参数，以获取投资回报期分析报告。

注意: 本服务器默认运行在 'http://127.0.0.1:8668/mcp' 地址，如果需要更改端口或主机，请修改 'src/mcp_server.py' 文件中的 uvicorn 启动配置。

关键词