newerton
服务介绍
Status Invest - MCP 服务器
该项目是 Model Context Protocol (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):
包括控制器（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 服务器配置
- 按
Ctrl+Shift+P并选择 "MCP: List Servers" - 选择 "stocks" 然后 "Start Server"
VSCode 中的 MCP 服务器输出
- 按
Ctrl+Shift+P并选择 "MCP: List Servers" - 选择 "stocks" 然后 "Show Output"
贡献
欢迎提交 Pull 请求！请随时提出问题并讨论改进。
许可证
本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。
