MCP Status Invest

🚀 状態投資 - MCP サーバー

このプロジェクトは、モデルコンテキストプロトコル（MCP）エコシステムの一部であり、外部 API や特定ドメインモデルとのやり取りを行うツールを提供します。外部 API 統合とデータ検証を備えた MCP サーバーの構築方法を示しています。

🚀 クイックスタート

この MCP サーバーを使用することで、状態投資 API を通じて株式市場データを取得できます。以下のセクションでは、機能、アーキテクチャ、インストール方法などについて説明します。

✨ 主な機能

• get-acoes：基本的な株式情報を取得します。
• get-indicadores：詳細な株式指標情報を取得します。
• get-acoes-datas-pagamento：株式の支払い日を取得します。
• Zod を使用した入力検証。
• fetch を使用した状態投資 API の統合（インフラストラクチャ層）。

🔧 技術詳細

アーキテクチャ

このプロジェクトは、ドメイン駆動設計（DDD）パターンにインスパイアされた階層化アーキテクチャに従っています。

• ドメイン (src/domain)： データ構造を表すインターフェースや型（例：StatusInvest）を定義します。

• インフラストラクチャ (src/infrastructure)： StatusInvestApiService などの外部サービスを実装し、状態投資 API への HTTP リクエストを担当します。

• アプリケーション層 (src/application)： StatusInvestService で業務ロジックを含み、インフラストラクチャからのデータを処理およびフォーマットします。

• インターフェース (src/interface)： コントローラー（StatusInvestToolsController）を含み、MCP サーバーにツールを登録し、検証モードを定義し、結果を返します。

• エントリーポイント (src/main.ts)： McpServer を初期化し、トランスポート（StdioServerTransport）を構成し、サービスとコントローラーをインスタンス化し、標準入出力のリスニングを開始します。

ファイル構造

src/
├── domain/
│   └── models/           # ドメインインターフェース
├── infrastructure/
│   └── services/         # 外部 API 実装（状態投資）
├── application/
│   └── services/         # 業務ロジックとデータフォーマット
├── interface/
│   └── controllers/      # MCP ツールの登録と検証
└── main.ts               # サーバーのエントリーポイント
build/                    # コンパイルされた JavaScript コード
.vscode/                  # mcp.json ファイルを含む、MCP サーバーの構成

📦 インストール

git clone git@github.com:newerton/mcp-status-invest.git
cd mcp-status-invest
npm install
npm run build

VSCode での MCP サーバー構成

1. ターミナルを開き、以下のコマンドを実行します。

   npm install -g npm
   

2. VSCode で「ターミナル」を開き、以下のコマンドを実行します。

   npm install -D @types/node typescript jsconfig.json
   

VSCode での MCP サーバー出力

// 言語モードを JavaScript または TypeScript に設定

🤝 貢献

Fork と Pull Request を歓迎します！提出する前に貢献ガイドを読んでください。

📄 ライセンス

このプロジェクトは MIT License の保護を受けています。