Constitution

한국기독교장로회 총회헌법 자료를 로컬 MCP stdio 서버로 조회하는 프로젝트입니다. 서버는 읽기 전용이며 HTTP 서버, 원격 호출, 데이터베이스, LLM, 임베딩을 사용하지 않습니다.

License: MIT Python 3.11+ MCP 1.27

AI에 연결하기

사전 요구: uv와 Python 3.11 이상.

Claude Code 플러그인 (가장 간단)

Claude Code에서 아래 두 줄이면 끝입니다. GitHub 저장소를 그대로 설치하므로 별도 vault 경로 설정이 필요 없습니다.

/plugin marketplace add addmirer144/PROK-constitution-mcp
/plugin install prok-constitution

설치 후 Claude Code를 재시작하면 search_constitution, get_constitution, get_related, verify_citation 도구가 노출됩니다.

다른 MCP 클라이언트 (Claude Desktop, Cursor 등)

PyPI에 배포된 뒤에는 클론 없이 uvx 한 줄로 실행할 수 있습니다. vault가 패키지에 번들되어 있어 --vault 지정이 필요 없습니다.

{
  "mcpServers": {
    "constitution": {
      "command": "uvx",
      "args": ["constitution-mcp"],
      "env": { "PYTHONDONTWRITEBYTECODE": "1" }
    }
  }
}

또는 저장소를 클론한 뒤 아래 JSON을 사용합니다. 경로는 클론 위치에 맞는 절대 경로로 바꾸십시오.

{
  "mcpServers": {
    "constitution": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/PROK-constitution-mcp/mcp_server",
        "constitution-mcp",
        "--vault",
        "/absolute/path/to/PROK-constitution-mcp/vault"
      ],
      "env": { "PYTHONDONTWRITEBYTECODE": "1" }
    }
  }
}

자세한 도구 설명과 로컬 실행법은 mcp_server/README.md를 보십시오.

구성

• mcp_server/: Python MCP 서버, CLI, 테스트, 패키지 설정
• vault/: 생성된 헌법 Markdown vault
• constitution_converter/, scripts/: vault 재생성 도구

MCP 서버 사용법은 mcp_server/README.md를 보십시오.

배포 기준

배포 후보는 다음 명령을 통과해야 합니다.

PYTHONDONTWRITEBYTECODE=1 uv run --directory mcp_server pytest -q
uv run --directory mcp_server ruff check src tests
uv run --directory mcp_server basedpyright
uv lock --directory mcp_server --check

Git에 올릴 때는 .venv, .obsidian, .omo, .DS_Store, 캐시와 빌드 산출물이 포함되지 않아야 합니다.

데이터와 라이선스

코드는 MIT 라이선스로 배포합니다. vault/의 원문 파생 데이터는 코드 라이선스와 별개이며, 공개 재배포 전에는 원문 출처와 재배포 권한을 확인해야 합니다. 자세한 내용은 DATA_POLICY.md를 보십시오.

비공식 안내

이 프로젝트의 응답은 원문 탐색을 돕는 비공식 로컬 조회 결과입니다. 총회 또는 교단의 공식 해석, 법률 자문, 치리 판단을 대신하지 않습니다.