ph-data-mcp-server

🇵🇭 ph-data-mcp-server

一个 MCP 服务，为 AI 助手（Claude、Cursor、VS Code Copilot 等）提供菲律宾数据：奖学金、节假日、地区、大学、比索汇率和天气。

可以向助手提出以下问题：

"Incoming college ako, BS Engineering. Anong scholarship pwede?" "2027 年有哪些法定节假日落在星期一？" "列出 Region X 的州立大学，以及面向这些学校学生开放的奖学金。"

无需 API 密钥。

工具

工具	功能	数据
ph_search_scholarships	根据问题查找匹配的奖学金（英语或 Taglish），可按教育阶段筛选	内置，离线
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 许可证。与所列的任何政府机构、基金会或学校均无关联。