Swiss Grounding

Swiss Grounding MCP

スイスについて、出典付きで回答します。

AI アシスタントに、連邦・州・市町村の公式情報に基づいた回答を提供する MCP サーバーです。
ドイツ語、フランス語、イタリア語、ロマンシュ語、英語に対応し、すべての回答で担当機関を明記します。

ライブで試す

スキャンしてスマートフォンで開く

Google Cloud Run のチューリッヒリージョン（europe-west6）で稼働し、mainからデプロイされています。 公開・読み取り専用です。登録も API キーも必要ありません。 ライブサーバー： swiss-grounding-mcp-542630986415.europe-west6.run.app MCP エンドポイント（Streamable HTTP）： https://swiss-grounding-mcp-542630986415.europe-west6.run.app/mcp ヘルスチェック： /health

以下のように1行でアシスタントに追加できます。例：Claude Code（その他のクライアント）：

claude mcp add --transport http swiss https://swiss-grounding-mcp-542630986415.europe-west6.run.app/mcp

アイドル時にはゼロまでスケールするため、休止後の最初のリクエストでインスタンスが起動します（約2秒後。ハイブリッド検索はさらに約10秒後に利用可能になり、それまではキーワード検索で回答します）。クライアントごとにレート制限を適用し、ブラウザーのオリジンからのリクエストを拒否します。また、6時間ごとにチェックしています。ホストされたインスタンスではこのリポジトリのコードが実行されており、ローカルでも実行できます。

仕組み

_{この例は、ライブサーバーが回答したチャレンジブリーフの質問例3です。}

スイスについて汎用アシスタントに質問すると、誤った州を対象にしたり、古いページや隣国の情報をもとに回答したりすることがあります。Swiss Grounding MCP は、代わりに所管機関自身のデータを提供します。

1. ツール呼び出しは1回。 アシスタントは13個の読み取り専用ツールから1つを選択します。場所は、人々が実際に入力する表記で利用できます。 Genf, Ginevra, Genève、Schuls → Scuol、8003、Bahnhofstrasse 1, Zürich。
2. 適切な所管機関。 回答は、構築済みインデックスに収録された10,630件の公式ページ（キーワード検索＋多言語セマンティック検索）、連邦のライブ API、市町村のオープンデータを通じて、所管するレベル（連邦機関、州、市町村）から取得されます。
3. 配慮があり、障害に強い。 robots.txt と利用規約を標準で遵守し、リクエストの間隔を調整してキャッシュします。情報源が停止している場合は、日付付きのコピーを提供するか、情報源を明示します。
4. 出典付きの回答は1つ。 すべてのツールは、引用文を一字一句そのまま含む共通の契約と、アシスタントが次に何をすべきかを示す5つのステータスのいずれかを返します。

対応範囲

宣言された対応範囲です。サーバーが何について、どの地域を対象に、どの機関の情報に基づいて回答するかを示します。アシスタントも swiss_coverage ツールで確認できます。

対象外と既知の制限事項

• スイス国外の内容。たとえば、コンスタンツのドイツの Rundfunkbeitrag については、サーバーがその旨を返します。
• GR、BL、SH の各州は自動クライアントをブロックするか、テキストを提供しないため、州のページはインデックスに含まれません（ch.ch と連邦政府のページは引き続き対象です。read_official_page はブロックされたことを正直に報告します）。VS（7 ページ）、TI（45 ページ）、TG（52 ページ）は一部のみインデックス化されています。
• 自治体のウェブページは、上記の 9 都市についてインデックス化されています（各 120～250 ページ、ローザンヌは 66 ページ、トゥーンは 32 ページ）。チューリッヒは数ページのみで、ベリンツォーナとフリブールはまだ対象外です（次回の更新では、フリブールの独自ドメイン ville-fribourg.ch をクロールします）。その他の自治体については、サーバーが公式ウェブサイトを返し、指定されたページをその場で読み取ることができます。
• 廃棄物収集カレンダーは、自治体がオープンデータを公開している場合にのみ利用できます。それ以外の場合、サーバーはその旨を伝え、自治体へのリンクを示します。祝日、保険料、地域の基本情報はすべての自治体を対象としています。
• 州法の本文、個別の税額計算、天気予報は提供していません。
• 学校の休暇は、公式リストを集約する OpenHolidays から取得しています。インデックスに管轄当局独自のカレンダー（例：ge.ch、bern.ch、シュクオルの学校）がある場合は、そのページを最初に引用し、EDK のリストと自治体のサイトも併記します。州が複数の学校種別の期間を公開している場合（ベルン州のドイツ語圏およびフランス語圏の学校など）は、期間に学校種別のラベルを付けます。
• ローザンヌへの到着時の住民登録については、弱点があります。市の住民登録窓口のページがインデックスに含まれていません。
• 言語をまたぐ質問：質問の言語が地域のページの言語と異なる場合、最初にページではなく言語に関するヒントが返され、アシスタントは再検索する必要があります。このような質問（ベルンについてフランス語で質問）のエンドツーエンド実行では、Sonnet はヒントに従ってベルンのページを参照して回答しました。Haiku は 4 回中 1 回で同様に対応しました。
• 検索はデフォルトでキーワードベースです。オプションの semantic エクストラを使うとハイブリッド検索になり、表現が異なるページや別の言語で書かれたページも見つけられますが、それでも見落としがあります（測定結果）。ロマンシュ語は埋め込みモデルの対象外です。

結果

このサーバーを使う場合と使わない場合。 同じ 28 個の質問（公開済みのサンプル 5 件、独自作成の 12 件、主催者の練習用ケース 11 件）を、使用ツールだけが異なる 3 通りの方法で Claude Code に Sonnet とともに質問しました。

サーバーを使うと、回答に必要な呼び出し回数と時間もウェブ検索の半分になります（1 問あたり 1.2 回対 2.4 回、14 秒対 28 秒）。ウェブ検索では正しい数値にたどり着くこともよくありますが、比較サイト、ニュース、観光情報のページが混在し、公式の数値が丸められることもあります。ツールがない場合、モデルはほとんどの場合、回答を控えるか、古い知識に基づいて回答します。

評価設定全体の結果： 2 つの MCP クライアント × 2 つの LLM を、公開済みのサンプル質問 5 件と独自作成の質問 11 件（de/fr/it/rm/en、聞き返し、対象外、未対応のケースを含む）で評価。実行日：2026-09-25

主催者の練習用パックでは、Sonnet は 11/11、Haiku は 10/11 でした。ハイブリッド検索では、ラベル付きの質問 38 件のうち 25 件について関連トピックの公式ページが見つかります（キーワード検索のみでは 19 件）。該当ページがない 5 件について、誤ったページを提示することはありません。すべての失敗例はdocs/evaluation.mdに記載されています。

自分で実行する

uv が必要です（Python 3.13 がインストールされます）。どのソースでも、API キーや認証情報は必要ありません。

git clone https://github.com/Gastaan/swiss-grounding-mcp && cd swiss-grounding-mcp
uv sync --extra semantic                                                  # dependencies, with hybrid search
uv run --extra semantic swiss-grounding-mcp                               # stdio (for local MCP clients)
uv run --extra semantic swiss-grounding-mcp --transport http --port 8000  # HTTP: http://localhost:8000/mcp
curl localhost:8000/health                                                # "search": "hybrid (…)"

事前構築済みのデータ（自治体登録簿、医療保険料、検索インデックス、パッセージベクトル）はリポジトリに含まれており、scripts/ のスクリプトで構築され、毎週更新されます（更新方法）。初回起動時にインデックスを展開し（約 1 秒）、小さな埋め込みモデルを一度だけダウンロードします（約 240 MB、バックグラウンドで実行され、準備が整うまではキーワード検索が使われます）。ハイブリッド検索なしで軽量にインストールするには、コマンドとクライアント設定から --extra semantic を削除してください（変更点）。

Docker： 公開済みイメージ（約 1.4 GB、ハイブリッド検索とそのモデルを含む）は、非特権ユーザーで実行され、実行時にダウンロードを行いません。

docker run -p 8000:8000 ghcr.io/gastaan/swiss-grounding-mcp                # HTTP: http://localhost:8000/mcp
docker run -i --rm ghcr.io/gastaan/swiss-grounding-mcp --transport stdio   # for a client that starts the server

または、docker build -t swiss-grounding-mcp . でビルドします。信頼できるネットワークの外部からポートにアクセスできる場合は、-e SGM_AUTH_TOKEN=<secret> を追加してください（HTTP セキュリティ）。クローンせずに実行する場合（キーワード検索）：uvx --from git+https://github.com/Gastaan/swiss-grounding-mcp swiss-grounding-mcp。

MCP クライアントを接続する

stdio または Streamable HTTP 経由で MCP に対応するクライアントであれば、どれでも動作します。Claude Code、OpenCode、MCP Inspector CLI、FastMCP クライアントで、従来の initialize ハンドシェイク（プロトコル 2025-06-18）とステートレスな 2026-07-28 プロトコルを含めてテスト済みです。ホスト型サーバーの場合は、その /mcp URL をリモート（HTTP）サーバーとして追加してください。クローンを使う場合は、絶対パスを指定し、/path/to/swiss-grounding-mcp を置き換えてください。サーバーは使用方法を示す instructions をクライアントに送信します。

claude mcp add swiss -- uv run --extra semantic --directory /path/to/swiss-grounding-mcp swiss-grounding-mcp
claude mcp add --transport http swiss-http http://localhost:8000/mcp

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "swiss": {"type": "local", "command": ["uv", "run", "--extra", "semantic", "--directory", "/path/to/swiss-grounding-mcp", "swiss-grounding-mcp"], "enabled": true, "timeout": 30000},
    "swiss-http": {"type": "remote", "url": "http://localhost:8000/mcp", "enabled": false, "timeout": 30000}
  }
}

{"mcpServers": {"swiss": {"command": "/full/path/to/uv", "args": ["run", "--extra", "semantic", "--directory", "/path/to/swiss-grounding-mcp", "swiss-grounding-mcp"]}}}

{"servers": {"swiss": {"type": "stdio", "command": "uv", "args": ["run", "--extra", "semantic", "--directory", "/path/to/swiss-grounding-mcp", "swiss-grounding-mcp"]}}}

{"mcpServers": {"swiss": {"command": "uv", "args": ["run", "--extra", "semantic", "--directory", "/path/to/swiss-grounding-mcp", "swiss-grounding-mcp"]}}}

ヒント

クライアントのリクエストタイムアウトは 30 秒以上に設定してください。OpenCode のデフォルトは 5 秒ですが、応答の遅い公式ソースではさらに時間がかかることがあります。サーバーはすべてのツール呼び出しを SGM_TOOL_TIMEOUT（30 秒）以内に終了し、適切な source_error を返します。そのため、クライアントのタイムアウトを 30 秒に設定すれば、その応答を受け取れます。

設定

設定は不要です。robots.txt と利用規約の遵守はデフォルトで有効で、無効にすることもできます。

キャッシュ、タイムアウト、オフラインモード、ベアラートークン、レート制限、許可するオリジン、ログ記録については、docs/configuration.md を参照してください。

ドキュメント

• 応答仕様とツール：各ツールが返す JSON、5 つのステータス、場所の扱い、全 13 個のツール
• 設定と運用：すべての設定、HTTP セキュリティ、キャッシュとソース利用のエチケット、監視、ホスト型インスタンス
• 検索：キーワード検索とセマンティックランキング、および測定済みの品質
• 評価：チャレンジのセルフチェック、エンドツーエンドの実行、既知の見落としすべて
• 開発：アーキテクチャ、データと毎週の更新、ソースの追加、テスト

_{Zurich 2026 の Swiss AI Weeks で開催された Swisscom myAI チャレンジSwiss Grounding MCP向けに構築されました。}