项目简介

这是一个基于 Model Context Protocol (MCP) 构建的服务器端应用。它集成了 Status Invest 网站的数据查询能力，通过标准化的 MCP 工具接口向支持 MCP 协议的客户端（如某些 LLM 集成开发环境插件）提供巴西股票市场的相关数据。

主要功能点

• 查询股票基本信息: 根据股票代码查询公司的基本信息，如当前价格、代码、名称等。
• 查询股票指标: 提供股票的详细财务和市场指标数据，例如市盈率、股息收益率、52周高/低点等。
• 查询分红日期: 根据日期范围和可选的股票代码，查询股票的分红、派息等支付日期信息。
• 支持对工具输入参数进行格式验证。

安装步骤

要安装和运行此 MCP 服务器，请遵循以下步骤：

1. 克隆 GitHub 仓库：

   git clone https://github.com/newerton/mcp-status-invest.git
   

2. 进入项目目录：

   cd mcp-status-invest
   

3. 安装项目依赖：

   npm install
   

4. 构建项目（编译 TypeScript 代码）：

   npm run build
   

服务器配置

MCP 服务器需要通过 MCP 客户端（例如支持 MCP 的 VSCode 插件）启动和连接。您需要在客户端中添加一个新的 MCP 服务器配置。典型的配置需要指定服务器的名称（客户端显示用）、启动服务器的命令 (command) 和参数 (args)。

根据此仓库的结构，配置信息大致如下：

• 名称 (Name): 可以是 "Status Invest" 或其他您方便识别的名称。
• 命令 (Command): 'node'
• 参数 (Args): 指向构建后生成的主文件路径，通常是 'build/main.js'。

在支持 MCP 的 VSCode 插件中，配置步骤通常是：打开命令面板 ('Ctrl+Shift+P' 或 'Cmd+Shift+P') -> 搜索 "MCP: List Servers" -> 添加新服务器。在配置界面填写上述信息。仓库的 README 提到在 VSCode 中选择 "stocks"，这可能是该服务器在特定客户端中的内部标识或预设名称。

基本使用方法

1. 确保您已完成安装和构建步骤。
2. 在您的 MCP 客户端（如 VSCode 插件）中配置并启动 "Status Invest" MCP 服务器。
3. 一旦服务器成功启动并连接到客户端，支持 MCP 的 LLM 或其他功能就可以通过标准接口调用此服务器提供的工具了。
4. LLM 可以根据用户请求调用以下工具：
   • 'get-acoes': 获取股票基本信息，需要提供股票代码列表。
   • 'get-indicadores': 获取股票指标信息，需要提供股票代码列表。
   • 'get-acoes-datas-pagamento': 获取分红支付日期，需要提供开始日期和结束日期，可选股票代码列表。
5. 服务器将返回查询到的股票数据作为工具执行结果。