PH Schools MCP Server MCP Server

Name: PH Schools MCP Server MCP Server
Author: io.github.darwinphi

io.github.darwinphi/ph-schools

Repository Registry

What is the PH Schools MCP Server MCP server?

Local stdio MCP server for searching and analyzing the Philippine schools masterlist dataset.

How to install PH Schools MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

PH_SCHOOLS_DATA_PATH
Absolute path to a local schools dataset JSON file.
PH_SCHOOLS_DATA_URL
Optional source URL used by sync-data.
PH_SCHOOLS_DATA_TAG
Optional canonical dataset tag used by sync-data when URL is not provided.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ph-schools": {
      "command": "npx",
      "args": [
        "-y",
        "@darwinphi/ph-schools-mcp-server"
      ],
      "env": {
        "PH_SCHOOLS_DATA_PATH": "<YOUR_PH_SCHOOLS_DATA_PATH>",
        "PH_SCHOOLS_DATA_URL": "<YOUR_PH_SCHOOLS_DATA_URL>",
        "PH_SCHOOLS_DATA_TAG": "<YOUR_PH_SCHOOLS_DATA_TAG>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "ph-schools": {
      "command": "npx",
      "args": [
        "-y",
        "@darwinphi/ph-schools-mcp-server"
      ],
      "env": {
        "PH_SCHOOLS_DATA_PATH": "<YOUR_PH_SCHOOLS_DATA_PATH>",
        "PH_SCHOOLS_DATA_URL": "<YOUR_PH_SCHOOLS_DATA_URL>",
        "PH_SCHOOLS_DATA_TAG": "<YOUR_PH_SCHOOLS_DATA_TAG>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ph-schools": {
      "command": "npx",
      "args": [
        "-y",
        "@darwinphi/ph-schools-mcp-server"
      ],
      "env": {
        "PH_SCHOOLS_DATA_PATH": "<YOUR_PH_SCHOOLS_DATA_PATH>",
        "PH_SCHOOLS_DATA_URL": "<YOUR_PH_SCHOOLS_DATA_URL>",
        "PH_SCHOOLS_DATA_TAG": "<YOUR_PH_SCHOOLS_DATA_TAG>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "ph-schools": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@darwinphi/ph-schools-mcp-server"
      ],
      "env": {
        "PH_SCHOOLS_DATA_PATH": "<YOUR_PH_SCHOOLS_DATA_PATH>",
        "PH_SCHOOLS_DATA_URL": "<YOUR_PH_SCHOOLS_DATA_URL>",
        "PH_SCHOOLS_DATA_TAG": "<YOUR_PH_SCHOOLS_DATA_TAG>"
      }
    }
  }
}

Claude Code

claude mcp add ph-schools --env PH_SCHOOLS_DATA_PATH=<YOUR_PH_SCHOOLS_DATA_PATH> --env PH_SCHOOLS_DATA_URL=<YOUR_PH_SCHOOLS_DATA_URL> --env PH_SCHOOLS_DATA_TAG=<YOUR_PH_SCHOOLS_DATA_TAG> -- npx -y @darwinphi/ph-schools-mcp-server