Ph Data Mcp Server

io.github.CharlieJamesGwapo由 GitHub 账号 CharlieJamesGwapo 发布v0.1.0更新于 Nov 5, 2026

Philippine scholarships, holidays, regions, schools, peso rates and weather. No API key.

已验证STDIO仅桌面位置与生活金融

概览

AI 生成的概览

本地 MCP 服务器，为助手提供菲律宾数据：奖学金、节假日、地区、学校、比索汇率和城市天气。

可以做什么
  • 搜索、浏览并查看菲律宾奖学金详情，包括资格、福利和申请方式
  • 列出 2026 与 2027 年的菲律宾法定与特别非工作日
  • 列出 17 个地区及其代码与中心，并按地区和类型筛选大学与学院
  • 按每日汇率在菲律宾比索与其他货币之间换算金额
  • 查询菲律宾主要城市的当前天气
  • 以文本或结构化 JSON 返回结果
适用场景
适合回答有关菲律宾教育资助、院校选择、公共假日、比索换算或当地天气的问题，包括他加禄语混英语的提问。所有工具均为只读，作为通用参考资料添加风险较低。
运行要求
通过 npx 以 stdio 在本地运行，需要 Node.js 20.3 或更高版本。无需 API 密钥或账号。实时工具（节假日、地区、学校、汇率、天气）需要网络访问。可选环境变量 PH_API_BASE_URL 可将实时工具指向其他 API 部署。
安装前请注意
奖学金数据是 35 个项目的精选集合，每学年都会变化，详情应在官方提供方页面核实。学校覆盖并不完整。汇率来自第三方汇率服务，天气来自 Open-Meteo，因此查询会发送到这些外部服务。所有工具均为只读。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Ph Data Mcp Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

🇵🇭 ph-data-mcp-server

An MCP server that gives AI assistants (Claude, Cursor, VS Code Copilot, and others) Philippine data: scholarships, holidays, regions, universities, peso exchange rates and weather.

Ask your assistant things like:

"Incoming college ako, BS Engineering. Anong scholarship pwede?" "Which regular holidays fall on a Monday in 2027?" "List state universities in Region X and the scholarships open to their students."

No API key needed.

Tools

ToolWhat it doesData
ph_search_scholarshipsFind scholarships that match a question (English or Taglish), optionally by levelBundled, offline
ph_get_scholarshipFull eligibility, benefits, period, how to apply, official linkBundled, offline
ph_list_scholarshipsBrowse with filters: level, provider type, regionBundled, offline
ph_list_holidaysRegular and special holidays (2026–2027)Live
ph_list_regionsAll 17 regions with codes and centersLive
ph_list_schoolsUniversities and colleges by region and typeLive
ph_convert_currencyConvert to or from PHP at daily ratesLive
ph_get_weatherCurrent weather in major citiesLive

Every tool is read-only and supports response_format: "json" for structured output.

About the scholarship data: 35 programs (DOST-SEI, CHED, TESDA, OWWA, DSWD, GSIS, DepEd, Quezon City, Davao, Cagayan de Oro, SM, Megaworld, Gokongwei, Security Bank, Aboitiz, DLSU, Ateneo, UST), each checked against the provider's own page. Details the official page doesn't state are null, never guessed. It's the same dataset as Iskolar AI. Programs change every school year, so always confirm on the official page.

The live tools use the free Philippines Public Data API.

Install

Requires Node.js 20.3 or later.

Claude Code

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

Claude Desktop (claude_desktop_config.json), Cursor (.cursor/mcp.json) and most other clients:

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

VS Code (.vscode/mcp.json):

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

Develop

bash
git clone https://github.com/CharlieJamesGwapo/ph-data-mcp-server.gitcd ph-data-mcp-servernpm installnpm run buildnpm run smoke                                        # calls every tool through a real MCP clientnpx @modelcontextprotocol/inspector node dist/index.js   # interactive testing

PH_API_BASE_URL points the live tools at another deployment of the API.

Releasing

  1. Bump version in package.json, server.json (both places) and src/index.ts.
  2. npm publish (the prepublishOnly script builds first).
  3. mcp-publisher login github then mcp-publisher publish to update the MCP Registry entry.

Contributing

Scholarship fixes and additions are welcome. Edit data/scholarships.json, cite the provider's own page (not a blog or aggregator), and set last_checked to today.

Support

If this is useful, ⭐ star the repo or sponsor the maintainer.

MIT License. Not affiliated with any agency, foundation or school listed.

来源：README.md，提交 777f9ae

工具

8

ph_search_scholarships

Search Philippine scholarships

Find Philippine scholarships and student financial aid that match a question, in English or Taglish (e.g. "incoming college, BS Engineering", "anak ng OFW", "TESDA courses", "grad school science"). Searches a curated list of programs (DOST, CHED, TESDA, OWWA, LGUs, foundations, universities) where every fact was checked against the official page. Returns the best matches with summary, period and official URL. Use ph_get_scholarship for full eligibility and benefits. Never state amounts or deadlines the results do not contain.

输入参数levellimitquery必填response_format

ph_get_scholarship

Get scholarship details

Full details of one Philippine scholarship by id (from ph_search_scholarships or ph_list_scholarships): eligibility, benefits, application period, how to apply, official and source URLs, and the date it was last checked. Fields the official page does not state are null.

输入参数id必填response_format

ph_list_scholarships

List Philippine scholarships

Browse the full curated list of Philippine scholarships with optional filters (level, provider type, region). Use ph_search_scholarships instead when you have a specific question.

输入参数levellimitoffsetregionprovider_typeresponse_format

ph_list_holidays

List Philippine holidays

Philippine regular and special non-working holidays (currently 2026 and 2027), with date, name and type. Example: "When is Holy Week 2027?" or "regular holidays this year".

输入参数typeyearresponse_format

ph_list_regions

List Philippine regions

The 17 regions of the Philippines with code (e.g. NCR, R10, BARMM), name, island group and regional center. Use the codes as the region filter in ph_list_schools.

输入参数island_groupresponse_format

ph_list_schools

List Philippine universities and colleges

Philippine universities and colleges with code, type (e.g. State, Private), city and region. Filter by region code from ph_list_regions (e.g. "R10") and by type (e.g. "State"). Partial coverage, not every school.

输入参数typelimitoffsetregionresponse_format

ph_convert_currency

Convert currency (Philippine peso rates)

Convert an amount between currencies using current exchange rates based on the Philippine peso (PHP), e.g. 100 USD to PHP. Rates come from open.er-api.com and update daily.

输入参数tofrom必填amountresponse_format

ph_get_weather

Current weather in a Philippine city

Current weather (temperature, humidity, feels-like, rain, wind) for a major Philippine city, from Open-Meteo. Use a city slug such as "manila", "quezon-city", "cebu-city", "davao-city" or "cagayan-de-oro".

输入参数city必填response_format

版本历史

1
  1. v0.1.0最新Nov 5, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分