explaingit

koul777/public-regulation-mcp-builder

Analysis updated 2026-05-18

29PythonAudience · ops devopsComplexity · 4/5LicenseSetup · hard

TLDR

A Windows tool that turns approved government regulation documents into a searchable knowledge base AI assistants can query through MCP, showing only human approved content.

Mindmap

mindmap
  root((PR MCP Builder))
    What it does
      Parses regulation documents
      Tracks revision history
      Builds MCP connection
    Tech stack
      Python
      Streamlit
      MCP protocol
    Use cases
      Search approved regulations
      Connect to ChatGPT or Claude
      Track amendment history
    Audience
      Government operators
      Compliance teams
    Safeguards
      Human approval gate
      Security level ACL
      Fail closed dates

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Convert PDF, HWP, HWPX, or DOCX regulation documents into a structured, versioned knowledge base.

USE CASE 2

Let an AI assistant answer questions using only human approved regulation text with citations.

USE CASE 3

Track amendment history so the latest valid revision of a regulation is always used.

USE CASE 4

Enforce security level and department access rules on who can see which regulation content.

What is it built with?

PythonStreamlitMCPWindows

How does it compare?

koul777/public-regulation-mcp-builderadityasharmadotai-hash/docs-reader-rag-agentalekseiul/hermes-researcher-agent
Stars292929
LanguagePythonPythonPython
Setup difficultyhardeasymoderate
Complexity4/52/52/5
Audienceops devopsvibe coderresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Windows only, needs Python 3.11+, optional Kordoc for HWP tables, and per AI program MCP registration steps.

MIT license: free to use, modify, and distribute, including commercially, as long as you keep the copyright notice.

In plain English

PR MCP Builder is a Windows tool for turning official South Korean public institution regulation documents into a searchable knowledge base that AI programs can query safely. It takes files in PDF, HWP, HWPX, and DOCX formats and organizes them into a structure of institution, regulation, revision version, and chapter, section, article, so that when a revised version of a regulation is uploaded, the tool reads the enactment and amendment history at the top of the document and links it to the correct existing regulation series instead of treating it as unrelated. Rather than chopping every document into same sized chunks and relying only on similarity search, the tool first narrows down by regulation name and table of contents, then finds the article text in the most recently valid revision, tracing back through older revisions when needed. Crucially, only content that a human has reviewed and approved gets included in the search index or in answers given through MCP, which stands for Model Context Protocol, the standard this tool uses to expose the regulation data to AI assistants like ChatGPT, Claude, and Codex. The project includes a Streamlit based local interface for the person running it to process, review, and approve documents before a connection bundle is generated. It supports connecting to several different AI programs, including ChatGPT Desktop, ChatGPT's remote HTTPS mode, Claude Desktop, and Claude Code, each with its own setup steps and automated verification that the connection actually works end to end. Beyond basic parsing, the tool pays close attention to correctness for legal and administrative documents: it applies security level and department access rules so that higher clearance content is not shown to lower clearance viewers, it handles repealed or superseded regulations and retroactive amendments by defaulting to the safer option when unsure, and it works around known quirks in Korean HWP and HWPX table formats, DOCX merged table cells, and Unicode text normalization to keep search results accurate. The README states this is an actively developed, source available project, not yet a finished product, and warns that real deployment inside a government or public institution would need further validation of document formats, revision history handling, and security policy before use. It is released under the MIT license and requires Python 3.11 or newer on Windows 10 or 11.

Copy-paste prompts

Prompt 1
Walk me through processing a PDF regulation document with PR MCP Builder and getting it approved.
Prompt 2
Help me connect PR MCP Builder's MCP server to Claude Code using the scope user setup.
Prompt 3
Explain how PR MCP Builder decides which revision of a regulation is currently valid.
Prompt 4
Show me how to verify an MCP connection works end to end with initialize, tools list, and get index status.

Frequently asked questions

What is public-regulation-mcp-builder?

A Windows tool that turns approved government regulation documents into a searchable knowledge base AI assistants can query through MCP, showing only human approved content.

What language is public-regulation-mcp-builder written in?

Mainly Python. The stack also includes Python, Streamlit, MCP.

What license does public-regulation-mcp-builder use?

MIT license: free to use, modify, and distribute, including commercially, as long as you keep the copyright notice.

How hard is public-regulation-mcp-builder to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is public-regulation-mcp-builder for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.