boutique-mcp

boutique-mcp

MateMatic Boutique のローカル MCP カタログです。法務データ向け MCP コネクター（SAOS、CBOSA、EUR-Lex、オーストリアから日本までの各国 ELI サーバー）、MateMatic のエージェントスキル、厳選されたサードパーティ製スキルを収録しています。現在の件数はこのファイルではなく、カタログ本体（catalog.json の counts）に記載されています。

このカタログが答えるのは、「目の前のタスクを解決する構成要素はどれか、ローカルにインストールする方法は何か」という問いです。カタログは案内するだけで、プロキシとして動作することはありません。エージェントにはコピーして貼り付けられる uvx／npx コマンドまたはダウンロードリンクが渡され、それを使ってお使いのマシン上で実行します。

ステータス：v0.1.0 | ライセンス：Apache-2.0 | メンテナー：MateMatic

ローカルである理由

ホスト型の検索 API は、回答するすべてのクエリを把握します。法務業務では、クエリ自体が機密情報である場合も少なくありません（「依頼人の主張に対する反論……」など）。このコネクターが情報を取得することはありません。検索は catalog.json のローカルコピーを使い、プロセス内で実行されます。唯一行われるネットワークリクエストは、公開カタログに対する条件付き GET（ETag／If-None-Match）だけです。

ネットワークに接続できない場合は、ディスクにキャッシュされた最新のカタログか、パッケージに同梱されたスナップショットを使用します。いずれの場合も、応答にはデータの取得元と経過時間が示されます。「カタログ生成日：X、取得元：ネットワーク／ディスクキャッシュ／同梱スナップショット」のように表示されます。インストールや実行が代わりに行われることはありません。カタログがコマンドを返し、それを実行するのはご自身です。

MCP ツール

• boutique_search(query, jurisdiction?, entry_type?, limit?) - カタログを対象としたキーワード検索（英語、ポーランド語、ポルトガル語）です。すべての検索結果にローカルでのインストールコマンドが含まれます。該当する項目がない場合、関連性の低い候補で埋めるのではなく、応答の gaps[] に不足情報が示されます。
• boutique_get(id) - 1 つの項目の詳細カードを返します。利用可能なすべての言語での名称と説明、インストール方法、バージョン、ライセンス、ソース、カードの URL が含まれます。
• boutique_whats_new(since_date?) - 指定した日付以降に追加または更新された項目を返します（デフォルトはカタログ生成前の 30 日間です）。
• boutique_coverage() - このカタログが対象とする内容、その情報源、対象外の内容を示します。それぞれの不足情報には、固定 ID と代替手段が含まれます。検索結果がない場合は呼び出してください。カタログに対象範囲の不足がある可能性があります。
• boutique_request_coverage(description, jurisdiction?) - 対象範囲の不足を報告する課題の下書きを作成します。下書きのみです。どこにも送信されず、人が確認してから提出します。

クイックスタート

uvx boutique-mcp

MCP クライアントの設定（mcp-servers.json）：

{
  "mcpServers": {
    "boutique": {
      "command": "uvx",
      "args": ["boutique-mcp"]
    }
  }
}

Smart App Control を有効にした Windows 11

Smart App Control は署名されていない実行ファイルをブロックします。対象には uvx.exe、pip.exe、および pip のインストール時に作成されるランチャー boutique-mcp.exe が含まれます。python.org のインストーラーから入手した python.exe と py.exe は Python Software Foundation の署名付きなので、インタープリターからモジュールを実行すれば動作します。

python -m pip install boutique-mcp
python -m boutique_mcp

同じ理由で pip.exe もブロックされるため、pip install ではなく python -m pip を使ってインストールしてください。python が PATH にない場合は、Windows ランチャーを使用してください：py -3 -m boutique_mcp。

{ "mcpServers": { "boutique-mcp": { "command": "python", "args": ["-m", "boutique_mcp"] } } }

回避策として Smart App Control を無効にしないでください。Windows を再インストールしない限り、再び有効にすることはできません。

設定

環境変数	デフォルト	説明
BOUTIQUE_MCP_CATALOG_URL	https://matematicsolutions.com/catalog.json	カタログの取得元
BOUTIQUE_MCP_CACHE_DIR	~/.matematic/cache/boutique-mcp	ディスクキャッシュの保存先
BOUTIQUE_MCP_OFFLINE	未設定	1 = ネットワークに一切接続しません
BOUTIQUE_MCP_AUDIT	未設定	1 = ローカル監査ログをオプトインで有効化します（記録するのはツール名と所要時間のみで、クエリ内容は記録しません）

データソース

catalog.json は www-matematic リポジトリで、Boutique ページのタイルと同じソースから生成されます（3 言語に対応）。2 つの内容に差異が生じると、コミット前チェックおよび CI チェックで失敗します。機械可読なサーバーカードは /.well-known/mcp/server-card.json にあります。

開発

python -m venv .venv
.venv/bin/pip install -e ".[dev]"        # Windows: .venv\Scripts\pip
.venv/bin/python -m pytest tests/ -q     # offline - fixture catalog
.venv/bin/python -m ruff check src tests

ガバナンス

プロジェクト憲章では、ホスト型の検索・実行プロキシと、クエリ内容のログ記録を禁止しています。MateMatic が把握できる採用指標は、公開されている catalog.json ファイルの CDN ダウンロード数のみです。外部向けのテキストを生成する唯一のツール boutique_request_coverage は、下書きの作成までにとどまり、送信は人間が行います。

憲章と仕様は、このリポジトリの .matematic/ にあります。