Investidor10 - MCP Server

此集成可让 MCP 工具使用 Investidor10 API 查询股票价格、指标等股市数据。

目录

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

功能

• get-acoes：获取股票基本信息。
• 使用 Zod 验证输入。
• 使用 fetch 与 Investidor10 API 集成（基础设施层）。

架构

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

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

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

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

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

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

文件夹结构如下：

src/
├── domain/
│   └── models/           # Domain interfaces
├── infrastructure/
│   └── services/         # External API implementations (Investidor10)
├── 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-investidor10.git
cd mcp-investidor10
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 文件。