MCP 服务器

MCP サーバー

このプロジェクトには複数の MCP（Model Context Protocol）サーバーが含まれており、それぞれ異なる機能モジュールを提供します。

📖 完全なドキュメントサイト：https://a09090443.github.io/mcp-servers/

ディレクトリの機能概要

date

日時とタイムゾーンを扱うサービスで、日付とタイムゾーンに関する機能を提供します：

• 今日の日付を取得（カスタム形式に対応）
• 特定のタイムゾーンの現在の日付と時刻を取得
• 異なるタイムゾーン間で日時を変換
• 利用可能なタイムゾーンの一覧を取得
• 地域別によく使われるタイムゾーンを取得
• 日付が今日かどうかを検証

excel

Excel ファイル処理サービスで、さまざまな Excel ファイル操作機能を提供します：

• Excel ファイルの作成、読み取り、書き込み
• ワークシートの管理（新規作成、一覧表示、削除、名前変更）
• セル、行、列、範囲のデータの読み書き
• セル範囲の結合
• CSV ファイルのインポートとエクスポート

filesystem

ファイルシステム操作サービスで、ファイルとディレクトリを包括的に管理する機能を提供します：

• ファイル／ディレクトリの存在確認
• ファイルの読み書き、作成、削除
• ファイルのコピーと移動
• ディレクトリの作成と内容の一覧表示
• ファイルのメタデータと詳細情報の取得

google-drive

Google Drive ファイル操作サービスで、Google Drive との連携機能を提供します：

• ファイルの作成、アップロード、ダウンロード、更新、移動、名前変更、削除
• フォルダーの作成とファイル構造の管理
• ファイルの検索（全体または指定ディレクトリ）とメタデータの取得
• ファイル名からファイル ID を検索、ファイルの存在確認

gmail

Gmail メール操作サービスで、メールの送受信と管理機能を提供します：

• メールの送信（CC と複数の添付ファイルに対応）
• 受信トレイの未読メールを一覧表示
• Gmail の検索構文を使用したメール検索
• メール ID からメールの詳細を取得
• メールを既読／未読に設定
• メールの削除

google-map

Google Maps Places API による場所検索サービスで、場所の検索と詳細情報の取得機能を提供します：

• テキスト検索で場所を検索し、評価、価格帯、場所の種類などで絞り込み
• 座標と半径を指定して近くの場所を検索
• 場所名のオートコンプリート候補
• Place ID から場所の詳細情報を取得
• 場所の写真を取得（写真リソース名を指定、または Place ID から一度に取得）
• 利用可能な field mask フィールドの説明を確認

cwa-tw

台湾中央気象署の気象監視サービスで、リアルタイムの気象データと地震データへのアクセス機能を提供します：

• 台湾各県市に対応する API コードを検索
• 台湾全土の郷鎮の天気予報を取得（時間範囲は 24 時間以内）
• 指定地域の地震観測データを取得（時間範囲は 36 時間以内）

tw-stock

台湾証券取引所（TWSE）のオープンデータサービスで、上場企業と市場データの検索機能を提供します：

企業情報

• 企業の基本情報、重要情報のお知らせ、日次の重要情報
• 月次売上高、配当分配、株主構成、財務データ
• 銀行業の貸借対照表

ESG 情報

• サステナビリティ報告書、機能委員会、サプライチェーン管理、リスク管理、その他の ESG 開示情報

市場相場

• 市場全体の指数、5 分指数（過去およびリアルタイム）
• 個別銘柄の日次取引情報、日次平均価格、人気上位 48 銘柄
• ETF ランキング、評価指標（株価収益率、配当利回りなど）
• 信用取引残高、信用買い残、空売り残高
• 外資の保有区分と保有上位 20 銘柄

市場動向

• ニュース一覧、市場イベント一覧

このモジュールでは、配当投資戦略、外資投資分析、投資銘柄のスクリーニング、市場の注目情報の監視、個別銘柄のトレンド分析を網羅する MCP プロンプトのテンプレートも提供します。

技術アーキテクチャ

すべてのサービスは Gradle のマルチモジュール構成で同じビルドにまとめられ、単一の wrapper と version catalog を共有します。Kotlin 2.4.0 で開発され、Quarkus フレームワークと quarkus-mcp-server-stdio 拡張機能を基盤として、MCP 通信プロトコルを通じて他のシステムと連携します。各サービス間に依存関係はなく、それぞれ独立した uber-jar としてデプロイできます。実行環境には Java 21 が必要です。

ビルドコマンドはすべてルートディレクトリで実行します。例：./gradlew :tw-stock:build。