Socrata MCP 서버

Claude가 모든 Socrata 오픈 데이터 포털을 탐색하고 쿼리할 수 있는 도구를 제공하는 MCP 서버입니다.

도구

Related MCP server: mcp-data-kcmo

설치

사전 요구 사항

Python 3.10 이상이 필요합니다. 버전을 확인하세요:

python3 --version

Python을 설치하거나 업그레이드해야 하는 경우:

• macOS: brew install python (Homebrew 필요)

• Ubuntu/Debian / WSL: sudo apt update && sudo apt install -y python3 python3-venv python3-pip

• Fedora/RHEL: sudo dnf install python3

• Windows 11 네이티브: python.org에서 다운로드하고 설치 중에 Add to PATH를 체크하세요.

1. 이 폴더 복제 또는 복사

git clone https://github.com/your-username/socrata-mcp.git
cd socrata-mcp

또는 server.py 및 requirements.txt 파일을 원하는 폴더에 복사하세요.

2. 가상 환경 생성

python3 -m venv .venv

3. 가상 환경 활성화

활성화되면 프롬프트가 (.venv)로 변경됩니다.

4. 의존성 설치

pip install -r requirements.txt

5. 설치 확인

python3 server.py --help

다음과 같은 오류가 표시되어야 합니다:

RuntimeError: SOCRATA_DOMAIN environment variable is required

이는 서버가 올바르게 로드되었음을 의미합니다. 자격 증명만 구성하면 됩니다(아래 참조).

구성

두 환경 변수 모두 필수입니다. 없으면 서버가 시작되지 않습니다.

API 토큰을 얻으려면: Socrata 포털 로그인 → 개발자 설정(Developer Settings) → 새 앱 토큰 생성(Create New App Token)으로 이동하세요.

Claude Desktop에 추가

Claude Desktop은 JSON 구성 파일에서 MCP 서버 목록을 읽습니다. 플랫폼에 맞는 파일을 편집하세요:

macOS / Linux (네이티브)

{
  "mcpServers": {
    "socrata": {
      "command": "/absolute/path/to/socrata-mcp/.venv/bin/python3",
      "args": ["/absolute/path/to/socrata-mcp/server.py"],
      "env": {
        "SOCRATA_DOMAIN": "data.delaware.gov",
        "SOCRATA_APP_TOKEN": "your-api-key-here"
      }
    }
  }
}

/absolute/path/to/socrata-mcp를 실제 경로로 바꾸세요. 프로젝트 폴더 내에서 pwd를 실행하여 찾을 수 있습니다.

Windows 11 (네이티브 Python)

{
  "mcpServers": {
    "socrata": {
      "command": "C:\\Users\\YourName\\socrata-mcp\\.venv\\Scripts\\python.exe",
      "args": ["C:\\Users\\YourName\\socrata-mcp\\server.py"],
      "env": {
        "SOCRATA_DOMAIN": "data.delaware.gov",
        "SOCRATA_APP_TOKEN": "your-api-key-here"
      }
    }
  }
}

WSL을 사용하는 Windows 11

Claude Desktop은 Windows에서 실행되지만 wsl.exe를 통해 WSL 프로세스를 시작할 수 있습니다:

{
  "mcpServers": {
    "socrata": {
      "command": "wsl.exe",
      "args": [
        "--exec",
        "/home/your-wsl-username/socrata-mcp/.venv/bin/python3",
        "/home/your-wsl-username/socrata-mcp/server.py"
      ],
      "env": {
        "SOCRATA_DOMAIN": "data.delaware.gov",
        "SOCRATA_APP_TOKEN": "your-api-key-here"
      }
    }
  }
}

your-wsl-username을 WSL 사용자 이름으로 바꾸세요(확인하려면 WSL 내에서 whoami 실행).

구성을 편집한 후 Claude Desktop을 다시 시작하면 Socrata 도구를 사용할 수 있습니다.

라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다.

이 코드는 Anthropic의 Claude를 사용하여 생성되었습니다.

쿼리 예시

• "Delaware 오픈 데이터 포털에서 사용할 수 있는 데이터셋은 무엇인가요?"

• "2025 회계연도 계약 지출 기준 상위 공급업체를 보여줘"

• "데이터셋 sifm-293u에는 어떤 열이 있나요?"

• "작년에 클라우드 솔루션에 가장 많은 비용을 지출한 기관은 어디인가요?"

• "data.delaware.gov에서 교육 데이터셋 검색"