주소 조회를 통해 등록 인원, 인구 통계, 경계 정보를 포함한 미국 학구 및 학교 데이터에 AI agent가 접근할 수 있도록 합니다.
다른 이름 DistrictAPI/districtapi-mcp, districtapi-mcp
- 스타
- 0
- Tools
- 6
- 다운로드, 30일
- 160
- 최신 버전
- 0.1.3
- 마지막 커밋
- 2026년 10월 4일
- 라이선스
- —
DistrictAPI MCP란?
DistrictAPI은(는) MCP server입니다. 주소 조회를 통해 등록 인원, 인구 통계, 경계 정보를 포함한 미국 학구 및 학교 데이터에 AI agent가 접근할 수 있도록 합니다. 6개 도구를 제공합니다. 예: lookup_district_by_address, get_district, search_districts.
프로젝트 README에서 생성된 요약
DistrictAPI MCP server 정보
DistrictAPI는 AI agent에게 미국의 포괄적인 학구 및 학교 정보에 대한 접근 권한을 제공합니다. 이 MCP server를 사용하면 Claude, Cursor 또는 Copilot과 같은 어시스턴트가 등록 인원, 인구 통계, 지리적 경계와 같은 특정 데이터 포인트를 검색할 수 있습니다. 개발자는 pip 또는 uvx를 사용하여 이 server를 로컬 환경에 통합하고 AI 클라이언트를 districtapi.dev 데이터 소스에 연결할 수 있습니다.
사용자는 요청 인증을 위해 설정에 DISTRICTAPI_KEY를 제공해야 합니다. 이 server는 도로 주소를 통해 학구를 찾는 lookup_district_by_address 및 반경 기반 검색을 위한 find_schools_near_address를 포함하여 데이터 검색을 위한 여러 전문화된 도구를 제공합니다. 또한 이름 또는 주(state)로 검색하거나, NCES LEA 또는 학교 ID를 사용하여 전체 프로필을 가져오고, 특정 학구 내의 모든 학교 목록을 조회하는 기능도 지원합니다.
활용 사례
- 1지역 학구 식별미국 내 특정 도로 주소에 해당하는 학구를 찾습니다.
- 2학구 등록 데이터 조회AI 어시스턴트에게 특정 학구의 학생 등록 인원을 확인하도록 요청합니다.
- 3주변 교육 기관 위치 파악특정 위치에서 일정 거리 내에 있는 학교를 검색합니다.
- 4상세 학교 프로필 접근NCES 학교 ID를 사용하여 특정 학교에 대한 전체 정보를 가져옵니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
DistrictAPI MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 DistrictAPI MCP 설치
$ claude mcp add --env 'DISTRICTAPI_KEY=<YOUR_DISTRICTAPI_KEY>' districtapi-mcp -- uvx districtapi-mcpCursor에 DistrictAPI MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"districtapi-mcp": {
"command": "uvx",
"args": [
"districtapi-mcp"
],
"env": {
"DISTRICTAPI_KEY": "<YOUR_DISTRICTAPI_KEY>"
}
}
}
}VS Code에 DistrictAPI MCP 설치
.vscode/mcp.json
{
"servers": {
"districtapi-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"districtapi-mcp"
],
"env": {
"DISTRICTAPI_KEY": "<YOUR_DISTRICTAPI_KEY>"
}
}
}
}VS Code CLI에 DistrictAPI MCP 설치
$ code --add-mcp '{"name":"districtapi-mcp","type":"stdio","command":"uvx","args":["districtapi-mcp"],"env":{"DISTRICTAPI_KEY":"<YOUR_DISTRICTAPI_KEY>"}}'Claude Desktop에 DistrictAPI MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"districtapi-mcp": {
"command": "uvx",
"args": [
"districtapi-mcp"
],
"env": {
"DISTRICTAPI_KEY": "<YOUR_DISTRICTAPI_KEY>"
}
}
}
}Codex에 DistrictAPI MCP 설치
$ codex mcp add districtapi-mcp --env 'DISTRICTAPI_KEY=<YOUR_DISTRICTAPI_KEY>' -- uvx districtapi-mcpCodex config.toml에 DistrictAPI MCP 설치
~/.codex/config.toml
[mcp_servers.districtapi-mcp] command = "uvx" args = ["districtapi-mcp"] [mcp_servers.districtapi-mcp.env] DISTRICTAPI_KEY = "<YOUR_DISTRICTAPI_KEY>"
Gemini CLI에 DistrictAPI MCP 설치
$ gemini mcp add -s user -e 'DISTRICTAPI_KEY=<YOUR_DISTRICTAPI_KEY>' districtapi-mcp uvx -- districtapi-mcpGemini settings.json에 DistrictAPI MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"districtapi-mcp": {
"command": "uvx",
"args": [
"districtapi-mcp"
],
"env": {
"DISTRICTAPI_KEY": "<YOUR_DISTRICTAPI_KEY>"
}
}
}
}DistrictAPI MCP 도구 6
README에서 감지됨lookup_district_by_addressget_districtsearch_districtsget_district_schoolsget_schoolfind_schools_near_address
| lookup_district_by_address | — | |
| get_district | — | |
| search_districts | — | |
| get_district_schools | — | |
| get_school | — | |
| find_schools_near_address | — |
구성
DISTRICTAPI_KEY필수비밀API key from https://districtapi.dev (free tier: 500 requests/month)
| 이름 | 설명 | 유형 |
|---|---|---|
| DISTRICTAPI_KEY | API key from https://districtapi.dev (free tier: 500 requests/month) | 필수비밀 |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능districtapi/districtapi-mcp is public and reachablegithub.com/districtapi/districtapi-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시districtapi-mcp names districtapi/districtapi-mcp as sourcepypi.org/project/districtapi-mcp/ ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)No license결함 발견
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-04github.com/districtapi/districtapi-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from districtapi-mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음30 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음6 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기districtapi-mcp
mcp-name: dev.districtapi/districtapi-mcp
MCP server for districtapi.dev — US school district and school data for AI agents.
Expose school district lookups as tools to any MCP-compatible AI assistant (Claude, Cursor, Copilot, etc.).
Installation
pip install districtapi-mcp
Or run directly with uvx (no install needed):
uvx districtapi-mcp
Configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"districtapi": {
"command": "uvx",
"args": ["districtapi-mcp"],
"env": {
"DISTRICTAPI_KEY": "your_api_key_here"
}
}
}
}
Cursor / other MCP clients
{
"mcpServers": {
"districtapi": {
"command": "uvx",
"args": ["districtapi-mcp"],
"env": {
"DISTRICTAPI_KEY": "your_api_key_here"
}
}
}
}
Get a free API key at districtapi.dev.
Available Tools
| Tool | Description |
|---|---|
lookup_district_by_address |
Find the district serving a US street address |
get_district |
Get full district profile by NCES LEA ID |
search_districts |
Search districts by name and/or state |
get_district_schools |
List all schools in a district |
get_school |
Get full school profile by NCES school ID |
find_schools_near_address |
Find schools within a radius of an address |
Example
Once configured, you can ask your AI assistant:
"What school district serves 1600 Pennsylvania Ave, Austin TX, and how many students are enrolled?"
The assistant will call lookup_district_by_address and return the full district profile.
Links
- Website: districtapi.dev
- PyPI: pypi.org/project/districtapi-mcp
- REST API docs: districtapi.dev/docs
License
MIT
DistrictAPI MCP 질문
DistrictAPI MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'DISTRICTAPI_KEY=<YOUR_DISTRICTAPI_KEY>' districtapi-mcp -- uvx districtapi-mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
DistrictAPI MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
DistrictAPI MCP는 어떤 도구를 제공하나요?
6개 도구를 제공합니다. 예: lookup_district_by_address, get_district, search_districts, get_district_schools, get_school.