tablecloth-mcp

TableCloth MCP

식탁보(TableCloth)의 "발견과 안전 실행환경 인계" 레이어를 MCP 서버로 제공합니다. 사용자의 상황이나 질의를 받아 지금 필요한 한국 공공(e-Gov)이나 금융 사이트를 찾아주고, 보안프로그램 설치의 번거로움 없이 깨끗한 일회용 Windows Sandbox로 그 사이트를 열어 줍니다.

이 서버가 하는 일은 보안프로그램 때문에 생기는 불편을 줄이고 알맞은 사이트를 찾아 주는 데까지입니다. 로그인이나 인증, 실제 업무 자동화(RPA)는 하지 않으며, 그 부분은 사용자가 직접 진행합니다.

설치

Claude Desktop이라면 확장(.mcpb) 설치가 간편하고, 그 외 클라이언트는 MCP 설정에 npx나 dnx 실행을 넣으면 됩니다. 모두 동일한 서버입니다.

Claude Desktop 확장 (.mcpb)

GitHub Release에서 tablecloth-mcp.mcpb를 받아 Claude Desktop 창에 끌어다 놓거나 Settings > Extensions 에서 설치합니다. Claude Desktop이 번들한 Node로 실행되는 순수 JS 번들이라 별도 런타임 설치가 필요 없고, 네이티브 바이너리가 없어 서명/공증이나 확장 재설치 시 잠금 문제도 없습니다(Windows, macOS). MCP 설정을 직접 편집할 필요도 없습니다. macOS에서의 launch_sandbox는 Apple Silicon과 최신 macOS의 macSandbox가 필요합니다.

npx로 실행 (Node 사용자, .NET 불필요)

순수 JS 패키지라 어떤 OS든 Node만 있으면 동작합니다(네이티브 바이너리 없음). @latest를 붙인 이유는 아래 업데이트 참고입니다. npx는 버전을 명시하지 않으면 캐시된 옛 버전을 계속 쓸 수 있어, 새 버전을 잘 받도록 @latest를 권합니다.

{
  "mcpServers": {
    "tablecloth": { "command": "npx", "args": ["-y", "tablecloth-mcp@latest"] }
  }
}

전역으로 설치해서 쓸 수도 있습니다.

npm install -g tablecloth-mcp
tablecloth-mcp

dnx로 실행 (.NET 10 SDK 사용자)

NuGet 툴 패키지를 별도 설치 없이 실행합니다.

{
  "mcpServers": {
    "tablecloth": { "command": "dnx", "args": ["TableCloth.Mcp", "--yes"] }
  }
}

전역 도구로 설치해서 쓸 수도 있습니다.

dotnet tool install -g TableCloth.Mcp
tablecloth-mcp

npx(순수 JS)는 Node가 있는 모든 OS에서, dnx는 .NET 10 SDK가 있는 모든 OS에서 동작합니다. 검색과 generate_wsb는 모든 OS에서 되고, launch_sandbox의 자동 실행은 러너가 있는 OS(Windows는 Windows Sandbox, macOS는 macSandbox)에서만 됩니다.

업데이트

MCP 서버는 클라이언트가 시작할 때 프로세스로 떠서 실행되고, 실행 중에는 새 버전으로 교체되지 않습니다. 그래서 새 버전은 클라이언트를 다시 시작해 서버를 새로 띄울 때 반영됩니다. Claude Desktop은 앱을 재시작해야 하고, Claude Code는 세션을 새로 시작하면 됩니다.

• 무엇이 자동으로 갱신되나: 카탈로그(사이트, 정책, 보안패키지 목록)는 서버가 런타임에 라이브로 받아오므로, 새 서비스나 정책 추가 같은 변경은 서버 버전을 올리지 않아도 바로 반영됩니다. 서버 버전 교체가 필요한 건 도구 동작 변경이나 버그 수정 같은 코드 변경뿐입니다.
• npx: 버전 없이 쓰면 캐시된 옛 버전을 계속 쓸 수 있어 tablecloth-mcp@latest를 권합니다. 그래도 npm 캐시 영향이 남을 수 있으니, 확실히 최신으로 받으려면 클라이언트 재시작 전에 npm cache clean --force를 한 번 해도 됩니다.
• dnx: 버전을 명시하지 않으면 실행할 때마다 최신 버전을 해석해 받습니다. 갱신 적시성이 중요하면 dnx 쪽이 더 유리합니다.
• 결정론이 필요하면(기업 배포 등) 버전을 고정하고([email protected], dnx는 --version) 의도적으로 올리는 방법도 있습니다. 갱신은 수동이 되지만 예측 가능합니다.

도구

도구	설명
search_services(query, category?, limit?)	표시명(한국어와 영어), URL, 보안패키지명, 검색 키워드를 대상으로 사이트를 검색합니다
get_service(id)	특정 서비스의 상세 정보(필요한 보안패키지 전체, 호환성 주의사항, 아이콘 URL)를 반환합니다
list_categories()	카테고리별 개수를 반환합니다
list_companions(query?)	보조 프로그램(공용 소프트웨어) 목록을 반환합니다
generate_wsb(serviceIds[])	실행용 .wsb XML 텍스트를 생성합니다(모든 OS). 지원 러너에서 실행합니다
launch_sandbox(serviceIds[])	즉시 샌드박스를 실행합니다. Windows는 Windows Sandbox, macOS(Apple Silicon)는 macSandbox, 그 외(Linux 등)는 TABLECLOTH_WSB_RUNNER 환경변수로 지정한 러너를 씁니다

예시 흐름 (연말정산)

1. search_services("연말정산") 또는 search_services("홈택스")로 홈택스 등 후보와 id를 얻습니다.
2. launch_sandbox(["<홈택스 id>"])를 호출하면 보안프로그램이 갖춰진 일회용 샌드박스가 뜨고 사이트가 열립니다.
3. 인증서나 간편인증, 연말정산간소화 조회와 발급은 사용자가 직접 진행합니다.

TableCloth 리포지터리에 의존하지 않습니다

런타임에 공개된 자산만 소비합니다.

용도	소스
카탈로그(사이트와 보안패키지 목록)	https://yourtablecloth.app/TableClothCatalog/Catalog.xml
아이콘	https://yourtablecloth.app/TableClothCatalog/images/<id>.png
샌드박스 실행 자산	GitHub Release latest/download의 tablecloth-prepare.ps1, SporkBootstrap_<arch>.exe, Spork_<arch>_Portable.zip

생성되는 .wsb는 무설치 Express 방식(PARAMETERIZED_WSB_SPEC.md 0.5절)을 따르며, 사이트 사전선택은 TABLECLOTH_SITE_IDS 환경변수 채널로 전달됩니다.

使い方のヒント：TableCloth スキルで自動接続する

政府の政策や金融商品、時事問題について話していて、「あれに申し込む」程度に言うだけでこのサーバーに接続されるようにするには、リポジトリの SKILL.md を Agent Skill としてインストールすることをおすすめします。このスキルは、ユーザーの行動の意図（申し込み、加入、アクセス、利用）を捉え、「サンドボックス」という言葉がなくても、TableCloth ツールで公式サイトを安全なサンドボックス内で開くよう案内します。ほかの検索 MCP（例：ウェブ検索）と併用すると、情報の検索はそちらに、実際の申し込みや利用はこのサーバーに振り分けられます。

インストールするには、SKILL.md を ~/.claude/skills/tablecloth/SKILL.md に配置します。フォルダー名の tablecloth がスキル名になります。Claude Desktop や claude.ai では、各アプリのスキル設定で管理します。

ツールの説明とサーバーの instructions にも同じ意図が組み込まれているため、スキルなしでもある程度は接続されますが、スキルを追加すると、より安定してルーティングされます。launch_sandbox の実際の実行環境については、以下の制約を参照してください。

制約

• launch_sandbox の自動実行ランナーは、Windows では Windows 11 の「Windows Sandbox」オプション機能、macOS では macSandbox（Apple Silicon、macOS 26）です。Linux のように標準のランナーがない OS では、.wsb のパスを最初の引数として受け取るランナーコマンド（例：QEMU ベースのスクリプト）を、TABLECLOTH_WSB_RUNNER 環境変数に指定すると自動で実行します。この環境変数はすべての OS で標準値より優先されるため、カスタムランナーを接続する場合にも使用します。指定がない場合は、generate_wsb で .wsb を取得して実行できます。
• 認証が必要な操作は自動化しません。インストール不要の方式ではホストのファイルにアクセスできず、ファイル証明書を取り込めないため、モバイル認証または簡易認証を前提としています。
• カタログにないサービスは実行対象ではありません。報告は食卓布カタログから行ってください。

トラブルシューティング

接続できない、または応答がない場合は、TROUBLESHOOTING.md を参照してください。

最もよくある原因は、Claude Desktop が claude_desktop_config.json とは別にキャッシュしている古い MCP サーバー登録です。設定ファイルを修正しても削除されないため、同じ名前で登録された古いサーバー（例：ローカル開発ビルドやテスト用）が代わりに呼び出され、誤ったプロセスが起動したり、プロンプトが何分も停止したりします。解決するには、Settings の Developer（開発者ツール）で一覧に表示されている MCP サーバーをごみ箱アイコンから直接削除し（ファイルの編集だけでは削除されません）、拡張機能をすべて削除したうえで、Claude Desktop を完全に終了（トレイから終了、macOS では Cmd+Q）してから再起動します。

リリース

バージョンタグ（vX.Y.Z）をプッシュすると、.github/workflows/release.yml が同じバージョンで複数の場所にまとめて公開します。

• npm に純粋な JS パッケージ tablecloth-mcp を公開します（ネイティブバイナリなし）。
• NuGet に TableCloth.Mcp ツールパッケージ（C#）を公開します。
• GitHub Release に nupkg と Claude Desktop 拡張機能 .mcpb（Node バンドル）を添付します。
• 公式 MCP Registry にサーバーメタデータ（server.json）を公開します。GitHub OIDC で認証するため、シークレットは不要です。VS Code や Cursor などのほかのクライアントは、このインデックスからサーバーを検出します。

npm と NuGet への公開には OIDC Trusted Publishing を使用するため、長期トークンを保存せず、npm パッケージには provenance が自動で付与されます。変更履歴は CHANGELOG.md にまとめています。新しいバージョンをリリースする際は、そこに ## [X.Y.Z] セクションを追加してからタグをプッシュすると、その内容が GitHub Release のノートになります。

開発

レーンごとに 2 つの実装があり、どちらも shared/ を単一の信頼できる情報源として使用します（SPEC.md）。

• .mcpb + npm レーン：node/ の Node/TS 実装（純粋な JS）。cd node && npm ci && npm run build。
• NuGet ツール（dnx）レーン：このリポジトリのルートにある C# 実装。dotnet build -c Release。

2 つの実装の同等性は、適合性ハーネスで検証します：cd node && npm run conformance（事前にリポジトリのルートで dotnet build -c Release、node で npm run build を実行）。CI ではビルドごとに実行します。

プライバシーポリシー

このサーバーは、個人データや会話の内容、利用統計を収集、保存、送信しません。公開カタログ（yourtablecloth.app）と GitHub Release のアセットのみを読み込み、ユーザーデータを一緒に送信することはありません。launch_sandbox はローカルでサンドボックスを起動し、一時的な .wsb ファイルのみを作成します。ログインと認証はユーザーがサンドボックス内で直接行い、サーバーは関与しません。サーバーはステートレスで、終了後にデータを残しません。全文は PRIVACY.md を参照してください。

ライセンス

本プロジェクトは TableCloth と同様のデュアルライセンスです。

• AGPL-3.0-or-later（LICENSE-AGPL）のもとで、オープンソースとして利用できます。
• 商用利用において AGPL の義務を負いたくない場合は、開発者（Jung Hyun, Nam, rkttu at rkttu dot com）と協議のうえ、Commercial ライセンス（LICENSE-COMMERCIAL）を利用できます。

このサーバーは stdio のローカルプロセスとして動作し、MCP クライアントとは別プロセスで、プロトコルを介してのみ通信するため、呼び出し元に AGPL の義務が及ぶことはありません。