<div align="center">

Status Invest - MCP 服务器

该项目是 Model Context Protocol (MCP) 生态系统的一部分，提供了与外部 API 交互并管理特定领域模型的工具。它旨在展示如何构建一个具有外部 API 集成和数据验证功能的 MCP 服务器。

</div> <table style="border-collapse: collapse; width: 100%; table-layout: fixed;"> <tr> <td style="width: 40%; padding: 15px; vertical-align: middle; border: none;">通过使用 Status Invest API，该集成使 MCP 工具能够查询股票市场数据，如股票价格、指标和支付日期。</td> <td style="width: 60%; padding: 0; vertical-align: middle; border: none; min-width: 300px; text-align: center;"><a href="https://glama.ai/mcp/servers/@newerton/mcp-status-invest"> <img style="max-width: 100%; height: auto; min-width: 300px;" src="https://glama.ai/mcp/servers/@newerton/mcp-status-invest/badge" alt="Status Invest - MCP 服务器" /> </a></td> </tr> </table>

目录

• 特性
• 架构
• 安装
• VSCode 中的 MCP 服务器配置
• VSCode 中的 MCP 服务器输出
• 贡献
• 许可证

特性

• get-acoes: 获取基本的股票信息。
• get-indicadores: 获取详细的股票指标信息。
• get-acoes-datas-pagamento: 获取股票支付日期。
• 使用 Zod 进行输入验证。
• 使用 fetch（基础设施层）与 Status Invest API 集成。

架构

该项目遵循受 领域驱动设计 (DDD) 模式启发的分层架构：

• 领域 (src/domain): 定义表示数据结构的接口和类型（例如，StatusInvest）。

• 基础设施 (src/infrastructure): 实现外部服务，如 StatusInvestApiService，负责向 Status Invest API 发送 HTTP 请求。

• 应用 (src/application): 包含业务逻辑在 StatusInvestService 中，处理并格式化来自基础设施的数据。

• 接口 (src/interface): 包括控制器（StatusInvestToolsController），这些控制器在 MCP 服务器中注册工具，定义验证模式，并返回结果。

• 入口点 (src/main.ts): 初始化 McpServer，配置传输（StdioServerTransport），实例化服务和控制器，并开始监听 stdio。

文件夹结构如下：

src/ ├── domain/ │ └── models/ # 领域接口 ├── infrastructure/ │ └── services/ # 外部 API 实现 (Status Invest) ├── application/ │ └── services/ # 业务逻辑和数据格式化 ├── interface/ │ └── controllers/ # MCP 工具注册和验证 └── main.ts # 服务器入口点 build/ # 编译后的 JavaScript 代码 .vscode/ # 包含 mcp.json 文件，MCP 服务器配置

安装

bash git clone git@github.com:newerton/mcp-status-invest.git cd mcp-status-invest npm install npm run build

VSCode 中的 MCP 服务器配置

1. 按 Ctrl+Shift+P 并选择 "MCP: List Servers"
2. 选择 "stocks" 然后 "Start Server"

VSCode 中的 MCP 服务器输出

1. 按 Ctrl+Shift+P 并选择 "MCP: List Servers"
2. 选择 "stocks" 然后 "Show Output"

贡献

欢迎提交 Pull 请求！请随时提出问题并讨论改进。

许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。