STE Dictionary MCP 서버

텍스트를 ASD-STE100 Simple Technical English(STE)에 대해 검사하는 MCP 서버입니다: 어떤 단어가 승인되었는지, 어떤 단어가 아닌지, 그리고 각 위반을 대체하는 STE 단어가 무엇인지 확인합니다. data/의 정적 사전 스냅샷에서 완전히 오프라인으로 작동하며, 런타임 시 네트워크 액세스가 없습니다. 전체 설계는 docs/superpowers/specs/2026-08-21-ste-mcp-design.md를 참조하세요.

설정

pip install -r requirements.txt
python scripts/download_nltk_data.py
pytest

check_structure 도구에는 두 개의 작은 NLTK 데이터 패키지가 필요합니다(punkt_tab 문장/단어 토크나이저와 averaged_perceptron_tagger_eng 품사 태거 -- 딥러닝이 아닌 고전적인 통계 모델). 의존성을 설치한 후 python scripts/download_nltk_data.py를 한 번 실행하면 해당 패키지를 다운로드하고 NLTK 다운로더가 기본적으로 가져오는 비영어 토크나이저 언어를 정리하여 디스크 사용량을 ~58MB 대신 몇 MB로 유지합니다. 다시 실행해도 안전합니다. 이 단계를 건너뛰면 check_structure가 실행하라고 알리는 RuntimeError를 발생시킵니다.

서버는 STE_DATA_DIR 환경 변수에서 사전 스냅샷을 읽으며, 기본값은 ./data(서버가 시작된 작업 디렉터리 기준)입니다. data/의 스냅샷은 이 저장소에 커밋되어 있으므로 별도의 다운로드 단계가 필요 없습니다.

Related MCP server: mcp-textstats

독립 실행

python -m ste_mcp.server

stdio를 통해 MCP를 사용합니다.

Claude Code에 설치

Claude Code CLI에 서버를 등록합니다. PATH의 python에 mcp 패키지가 설치되어 있지 않으면 Python 인터프리터의 절대 경로를 사용하세요.

로컬 범위(Claude Code가 이 저장소에서 실행될 때만 사용 가능):

cd /absolute/path/to/ste-dictionary-mcp
claude mcp add --transport stdio --env STE_DATA_DIR=/absolute/path/to/ste-dictionary-mcp/data ste-dictionary -- python -m ste_mcp.server

사용자 범위(모든 디렉터리에서 사용 가능). 사용자 범위 서버는 이 저장소를 작업 디렉터리로 사용하지 않으므로, 먼저 저장소로 cd하는 작은 스크립트로 실행을 감싸세요(예: ~/.claude/ste-launcher.sh):

#!/bin/sh
cd /absolute/path/to/ste-dictionary-mcp
exec python -m ste_mcp.server

그런 다음 등록합니다:

chmod +x ~/.claude/ste-launcher.sh
claude mcp add --transport stdio --scope user --env STE_DATA_DIR=/absolute/path/to/ste-dictionary-mcp/data ste-dictionary -- ~/.claude/ste-launcher.sh

claude mcp list 또는 세션 내 /mcp로 확인하세요.

Claude Desktop 구성

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "ste-dictionary": {
      "command": "python",
      "args": ["-m", "ste_mcp.server"],
      "cwd": "/absolute/path/to/ste-dictionary-mcp",
      "env": {
        "STE_DATA_DIR": "/absolute/path/to/ste-dictionary-mcp/data"
      }
    }
  }
}

도구

check_word/check_text는 단어 목록 기반이며 문법 검사기가 아닙니다: 어휘를 검사하지 문장 구조를 검사하지 않습니다. check_structure는 단어 목록으로 잡을 수 없는 ASD-STE100 규칙에 대해 (전체 문법 엔진이 아닌 작은 통계적 품사 태거를 통한) 가벼운 구조 검사를 추가합니다 -- 정확한 규칙과 휴리스틱 한계는 ste_mcp/structure.py의 docstring을 참조하세요. 진단 전용입니다(재작성 제안 없음); 이 도구를 사용하는 에이전트가 재작성을 담당합니다.

일부 단어는 STE 승인 의미와 비STE 의미를 모두 가집니다(예: "long"은 일반 형용사로는 STE이지만 "as long as"/"no longer"는 그렇지 않습니다). 이러한 단어에 대해 check_word는 status: "non_ste" 대신 status: "ambiguous"를 반환하며, 호출자가 문맥에서 어떤 의미가 적용되는지 확인하도록 알리는 note를 함께 반환합니다. check_text는 이를 non_ste가 아닌 별도의 ambiguous 버킷/요약 개수로 보고합니다. status: "non_ste"는 일치하는 모든 의미가 비STE인 단어에만 예약됩니다.