boutique-mcp

boutique-mcp

MateMatic Boutique 的本地 MCP 目录： 法律数据 MCP 连接器（SAOS、CBOSA、EUR-Lex，以及从奥地利到日本的国家 ELI 服务）、MateMatic Agent 技能和精选的第三方技能。当前数量以目录本身中的数据为准（catalog.json 中的 counts），而非本文档。

它只回答一个问题：哪个构建模块能解决当前任务，以及如何在本地安装。目录只提供指引，不做代理。你的 Agent 会获得一条可复制粘贴的 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) - 获取某个条目的完整信息卡：所有可用语言的名称和描述、安装方式、版本、许可证、来源和信息卡 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 也会被阻止，因此请使用 python -m pip 安装，而不要使用 pip install。如果 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 页面卡片相同（三种语言）；每当两者出现不一致时，提交前检查和 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/。