ph-data-mcp-server

🇵🇭 ph-data-mcp-server

AI アシスタント（Claude、Cursor、VS Code Copilot など）に、奨学金、祝日、地域、大学、ペソの為替レート、天気などのフィリピンのデータを提供する MCP サーバーです。

アシスタントに次のような質問をしてみましょう。

「大学に進学予定で、工学部を希望しています。応募できる奨学金はありますか？」 「2027年の月曜日にあたる通常の祝日はどれですか？」 「Region X の国立大学と、そこに通う学生が応募できる奨学金を一覧にしてください。」

API キーは不要です。

ツール

ツール	内容	データ
ph_search_scholarships	質問に合った奨学金を検索します（英語またはタガログ語と英語の混合）。任意で学習段階も指定できます	同梱、オフライン
ph_get_scholarship	応募資格、給付内容、期間、申請方法、公式リンクの全情報を取得します	同梱、オフライン
ph_list_scholarships	学習段階、提供元の種類、地域で絞り込んで閲覧します	同梱、オフライン
ph_list_holidays	通常の祝日と特別な祝日（2026～2027年）を取得します	ライブ
ph_list_regions	コードと中心地を含む全17地域を取得します	ライブ
ph_list_schools	地域と種類で大学・短期大学を取得します	ライブ
ph_convert_currency	日次レートで PHP との通貨換算を行います	ライブ
ph_get_weather	主要都市の現在の天気を取得します	ライブ

すべてのツールは読み取り専用で、構造化出力用の response_format: "json" に対応しています。

奨学金データについて： 35のプログラム（DOST-SEI、CHED、TESDA、OWWA、DSWD、GSIS、DepEd、Quezon City、Davao、Cagayan de Oro、SM、Megaworld、Gokongwei、Security Bank、Aboitiz、DLSU、Ateneo、UST）が含まれており、それぞれ提供元の公式ページで確認済みです。公式ページに記載されていない詳細は推測せず、null としています。これは Iskolar AI と同じデータセットです。プログラムは毎年度変更されるため、必ず公式ページで確認してください。

ライブツールは、無料の Philippines Public Data API を使用します。

インストール

Node.js 20.3 以降が必要です。

Claude Code

claude mcp add ph-data -- npx -y ph-data-mcp-server

Claude Desktop（claude_desktop_config.json）、Cursor（.cursor/mcp.json）、およびその他の多くのクライアント：

{
  "mcpServers": {
    "ph-data": {
      "command": "npx",
      "args": ["-y", "ph-data-mcp-server"]
    }
  }
}

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "ph-data": { "type": "stdio", "command": "npx", "args": ["-y", "ph-data-mcp-server"] }
  }
}

Docker

docker build -t ph-data-mcp-server .
docker run -i --rm ph-data-mcp-server

開発

git clone https://github.com/CharlieJamesGwapo/ph-data-mcp-server.git
cd ph-data-mcp-server
npm install
npm run build
npm run smoke                                        # calls every tool through a real MCP client
npx @modelcontextprotocol/inspector node dist/index.js   # interactive testing

PH_API_BASE_URL は、ライブツールの接続先を別の API デプロイに指定します。

リリース

1. package.json、server.json（両方の箇所）、src/index.ts の version を更新します。
2. npm publish を実行します（prepublishOnly スクリプトが先にビルドします）。
3. mcp-publisher login github を実行してから mcp-publisher publish を実行し、MCP Registry のエントリーを更新します。

コントリビューション

奨学金情報の修正や追加を歓迎します。data/scholarships.json を編集し、提供元の公式ページを引用してください（ブログやアグリゲーターではなく）。last_checked には今日の日付を設定してください。

サポート

役に立った場合は、リポジトリに ⭐ を付けるか、メンテナーをスポンサーしてください。

MIT ライセンスです。記載されている機関、財団、学校とは一切関係ありません。