tablecloth-mcp
v0.3.0
Published
MCP server that finds Korean e-Gov/finance sites and opens them in a clean, disposable Windows Sandbox with the required security software. Discovery + safe-launch only (no RPA). Node/TS implementation (counterpart of the .NET dnx build). Dual-licensed: A
Maintainers
Readme
tablecloth-mcp (Node/TS 구현)
.mcpb(Claude Desktop)와 npm(npx) 레인을 위한 Node/TypeScript 구현입니다.
NuGet 도구(dnx) 레인의 .NET 구현과 counterpart이며, 둘 다 ../SPEC.md와
../shared/를 단일 진실 원천으로 소비합니다(구현 간 드리프트 방지).
순수 JS로 배포되어(네이티브 바이너리 없음) NativeAOT 매트릭스, 미서명 바이너리, macOS Gatekeeper, 확장 재설치 시 exe 잠금 문제가 없습니다. Claude Desktop 이 번들한 Node 로 실행됩니다.
개발
npm install
npm run build # gen(shared 인라인) + esbuild 단일 파일 번들 -> dist/index.js
npm run typecheck # tsc --noEmit
npm run conformance # .NET(bin/Release) 과 Node(dist) 를 stdio 로 띄워 출력 동등성 비교npm run conformance 전에는 리포 루트에서 dotnet build -c Release 와 이 폴더에서 npm run build 가
되어 있어야 합니다. 하네스는 tools/list(이름·주석·파라미터·제목·설명), 서버 지침, 대표 tools/call
출력, .wsb 바이트 일치를 검사하며, 하나라도 다르면 종료코드 1 입니다.
구조
scripts/gen-shared.mjs—../../shared/{strings.json,wsb-template.xml}를src/generated.ts로 인라인.src/catalog.ts— 공개 카탈로그 fetch/파싱/캐시(.NET CatalogClient 와 동일 규칙).src/tools/catalog-tools.ts— search_services, get_service, list_categories, list_companions.src/tools/sandbox-tools.ts— generate_wsb, launch_sandbox.src/index.ts— MCP stdio 서버, 도구 6개 등록.
