ステータス投資 - 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 ): Status Invest API への HTTP 呼び出しを行うStatusInvestApiServiceなどの外部サービスを実装します。
アプリケーション( 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