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）： 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 [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ファイルをご覧ください。