ステータス投資 - 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 ): 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 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. 「stocks」を選択し、「Start Server」を選択します

VSCode での MCP サーバー出力

1. Ctrl+Shift+Pを押して「MCP: サーバーの一覧」を選択します。

2. 「stocks」を選択し、「Show Output」を選択します

貢献

プルリクエストは大歓迎です！お気軽に問題を報告し、改善点について話し合ってください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。