Status Invest - MCP 服务器

Name: Status Invest MCP Server
Author: newerton

该项目是模型上下文协议 (MCP) 生态系统的一部分，提供与外部 API 交互和管理特定领域模型的工具。它旨在演示如何构建具有外部 API 集成和数据验证功能的 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 ）：包括在 MCP 服务器中注册工具、定义验证模式并返回结果的控制器（ StatusInvestToolsController ）。
入口点（ src/main.ts ）：初始化McpServer ，配置传输（ StdioServerTransport ），实例化服务和控制器，并开始监听stdio 。

文件夹结构如下：

src/ ├── domain/ │ └── models/ # Domain interfaces ├── infrastructure/ │ └── services/ # External API implementations (Status Invest) ├── application/ │ └── services/ # Business logic and data formatting ├── interface/ │ └── controllers/ # MCP tool registration and validation └── main.ts # Server entry point build/ # Compiled JavaScript code .vscode/ # Contains the mcp.json file, MCP Server config