Status Invest - MCP 服务器

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

目录

• 特征

• 建筑学

• 安装

• VSCode 中的 MCP 服务器配置

• VSCode 中的 MCP 服务器输出

• 贡献

• 执照

Related MCP server: Zerodha Trading 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

安装

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：列出服务器”

2. 选择“股票”，然后选择“启动服务器”

VSCode 中的 MCP 服务器输出

1. 按Ctrl+Shift+P并选择“MCP：列出服务器”

2. 选择“股票”，然后选择“显示输出”

贡献

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

执照

该项目根据 MIT 许可证进行授权 - 有关详细信息，请参阅LICENSE文件。