Investidor10 - MCP Server

Investidor10 API を使用して、株価などの株式市場データや指標を MCP ツールから取得できるようにする連携機能です。

目次

• 機能
• アーキテクチャ
• インストール
• VSCode での MCP サーバー設定
• VSCode での MCP サーバー出力
• コントリビューション
• ライセンス

機能

• get-acoes：株式の基本情報を取得します。
• Zod を使用して入力を検証します。
• fetch（インフラストラクチャ層）を使用して Investidor10 API と連携します。

アーキテクチャ

このプロジェクトは、ドメイン駆動設計（DDD）のパターンを参考にした階層型アーキテクチャを採用しています。

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

• インフラストラクチャ（src/infrastructure）： Investidor10 API への HTTP 呼び出しを担当する Investidor10ApiService など、外部サービスを実装します。

• アプリケーション（src/application）： インフラストラクチャから取得したデータを処理して整形する Investidor10Service にビジネスロジックを実装します。

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

• エントリーポイント（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 ファイルをご覧ください。