Status Invest - MCP Server

此集成可通过 Status Invest API 使用 MCP 工具查询股市数据，例如股票价格、指标和派息日期。

目录

• 功能
• 架构
• 安装
• 在 VSCode 中配置 MCP 服务
• 在 VSCode 中查看 MCP 服务输出
• 贡献
• 许可证

功能

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

架构

本项目采用受领域驱动设计（DDD）模式启发的分层架构：

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

• 基础设施（src/infrastructure）： 实现外部服务，例如负责向 Status Invest API 发起 HTTP 调用的 StatusInvestApiService。

• 应用（src/application）： 在 StatusInvestService 中包含业务逻辑，用于处理并格式化基础设施层的数据。

• 接口（src/interface）： 包含控制器（StatusInvestToolsController），用于在 MCP 服务中注册工具、定义验证架构并返回结果。

• 入口点（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

安装

git clone [email protected]: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”

贡献

欢迎提交拉取请求！欢迎提出问题并讨论改进方案。

许可证

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