Global law
The law of nearly every country on earth, any date: read it, see what changed it, check citations.
IGE/IPI Swissreg trademarks, patents, SPCs
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 0/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 12/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 12/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
Swiss Ip MCP をインストールして。https://mcp.popnx.com/i/malkreide-swiss-ip-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月13日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server Swiss Ip MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "swiss-ip": { "command": "uvx", "args": [ "swiss-ip-mcp" ], "env": { "IGE_USERNAME": "your-value", "IGE_PASSWORD": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) IGE_USERNAME, IGE_PASSWORD は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Swiss Ip MCP のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
SettingsDeveloperEdit Config
{
"mcpServers": {
"swiss-ip": {
"command": "uvx",
"args": [
"swiss-ip-mcp"
],
"env": {
"IGE_USERNAME": "your-value",
"IGE_PASSWORD": "your-value"
}
}
}
}キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Swiss Ip MCP を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が Swiss Ip MCP を使っていると言うか、回答に Swiss Ip MCP のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ Swiss Ip MCP につなげません
Swiss Ip MCP はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
A · Swiss Ip MCP につなげるアプリを使う
B · 法律・行政データ の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
Claude Code につなげますが、先に準備が必要です
Swiss Ip MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server Swiss Ip MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user swiss-ip --env IGE_USERNAME=your-value --env IGE_PASSWORD=your-value -- uvx swiss-ip-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) IGE_USERNAME, IGE_PASSWORD は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Swiss Ip MCP のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
claude mcp add --scope user swiss-ip --env IGE_USERNAME=your-value --env IGE_PASSWORD=your-value -- uvx swiss-ip-mcpEnter の前に「your-value」を自分のキーに書き換えてください
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Swiss Ip MCP が一覧にあり、接続済みと表示されれば OK です
Swiss Ip MCP を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が Swiss Ip MCP を使っていると言うか、回答に Swiss Ip MCP のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
Swiss Ip MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server Swiss Ip MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "swiss-ip": { "command": "uvx", "args": [ "swiss-ip-mcp" ], "env": { "IGE_USERNAME": "your-value", "IGE_PASSWORD": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) IGE_USERNAME, IGE_PASSWORD は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Swiss Ip MCP のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
Swiss Ip MCP の設定で IGE_USERNAME, IGE_PASSWORD が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Swiss Ip MCP を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が Swiss Ip MCP を使っていると言うか、回答に Swiss Ip MCP のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
Swiss Ip MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server Swiss Ip MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "swiss-ip": { "type": "stdio", "command": "uvx", "args": [ "swiss-ip-mcp" ], "env": { "IGE_USERNAME": "your-value", "IGE_PASSWORD": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) IGE_USERNAME, IGE_PASSWORD は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Swiss Ip MCP のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
Swiss Ip MCP の設定で IGE_USERNAME, IGE_PASSWORD が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Swiss Ip MCP を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が Swiss Ip MCP を使っていると言うか、回答に Swiss Ip MCP のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
Claude Code
claude mcp add --scope user swiss-ip --env IGE_USERNAME=your-value --env IGE_PASSWORD=your-value -- uvx swiss-ip-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"swiss-ip": {
"command": "uvx",
"args": [
"swiss-ip-mcp"
],
"env": {
"IGE_USERNAME": "your-value",
"IGE_PASSWORD": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"swiss-ip": {
"command": "uvx",
"args": [
"swiss-ip-mcp"
],
"env": {
"IGE_USERNAME": "your-value",
"IGE_PASSWORD": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"swiss-ip": {
"type": "stdio",
"command": "uvx",
"args": [
"swiss-ip-mcp"
],
"env": {
"IGE_USERNAME": "your-value",
"IGE_PASSWORD": "your-value"
}
}
}
}IGE_USERNAME 秘密 必須 envIGE_PASSWORD 秘密 必須 env説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
pypi: swiss-ip-mcpこのサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント malkreide で確認済みです
コードの最終更新:18 日前
MITを使用
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
OSV.dev に swiss-ip-mcp@1.2.0 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/malkreide-swiss-ip-mcp)質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
まだレビューはありません
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
入力が必要なもの:IGE_USERNAME, IGE_PASSWORD
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は18 日前、最新バージョン(1.2.0)がレジストリに届いたのは2 か月前です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。
同じカテゴリには:Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
The law of nearly every country on earth, any date: read it, see what changed it, check citations.
German court decisions (Rechtsprechung) and laws (Gesetze) with citation graph and citation checks.
Search French-language and European case law and French legal texts (codes, statutes, treaties).
Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.
Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.
| これ Swiss Ip MCP | Global law | Open Legal Data (Germany) | LibreJustice | InfraNode | Fedlex Connector | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 |
| キーが必要 | はい | いいえ | いいえ | いいえ | いいえ | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| 基本チェック | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 |
| ライセンス | MIT | NOASSERTION | MIT | Apache-2.0 | Apache-2.0 | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
🇨🇭 Part of the [Swiss Public Data MCP Portfolio](https://github.com/malkreide/swiss-public-data-mcp)
MCP Server for Swiss Intellectual Property Data (IGE/IPI)
🇩🇪 Deutsche Version → README.de.md
swiss-ip-mcp is a Model Context Protocol (MCP) server that gives AI models structured, language-driven access to the Swiss intellectual property register Swissreg, operated by the Swiss Federal Institute of Intellectual Property (IGE/IPI).
It is the successor to patent-mcp and covers all available domains of the Swissreg Datadelivery API: trademarks, patents, patent publications, and supplementary protection certificates (SPC/ESZ).
This server is model-agnostic. It works with Claude, GPT-4, Llama, and any other MCP-compatible client – not just Claude Desktop.
The real power is natural language. Instead of manually searching the register, just ask a question:
"Which trademarks does the City of Zurich hold at the IGE?"
"Is the name 'Learning City Zurich' registered as a trademark in Switzerland?"
"Which pharmaceutical companies have filed Swiss patents in the last six months?"
"Show me all trademark applications in the education sector (Nice class 41) since January 2025."
"What supplementary protection certificates does Novartis hold in Switzerland?"
| Domain | Description |
|---|---|
| Trademarks | Swiss trademark register – filing, protection, owners, Nice classes |
| Patents | CH patents – filing, grant, IPC classes, applicants, inventors |
| Patent publications | Official patent publications in the Swiss Official Gazette |
| SPC / ESZ | Supplementary protection certificates for medicinal and plant-protection products |
Note: Design search is not yet available in the Swissreg Datadelivery API.
| Tool | Function |
|---|---|
swiss_ip_search_trademarks | Free-text trademark search (wildcard * supported) |
swiss_ip_get_trademark | Retrieve a trademark by registration number |
swiss_ip_search_trademarks_by_owner | Find all trademarks held by a given owner |
swiss_ip_search_trademarks_by_class | Filter trademarks by Nice classification class |
swiss_ip_search_patents | Free-text patent search |
swiss_ip_get_patent | Retrieve a patent by number |
swiss_ip_search_patents_by_applicant | Find patents by applicant or inventor name |
swiss_ip_search_patent_publications | Search patent publications |
swiss_ip_search_spc | SPC/ESZ search (pharma and plant protection) |
swiss_ip_search_recent_filings | Filter filings by date range across all domains |
swiss_ip_get_quota | Check remaining API data transfer quota |
Beyond tools, the server exposes two more MCP primitives:
Resources (read-only metadata, swissip:// URI scheme):
| URI | Content |
|---|---|
swissip://about | Server + data-source metadata (provenance, covered domains) |
swissip://domains | List of covered IP domains |
Prompts (curated workflow templates):
| Prompt | Arguments | Purpose |
|---|---|---|
trademark_availability | name | Check whether a name is a registered Swiss trademark |
competitor_ip_report | company | IP overview (trademarks + patents) for a company |
recent_ip_filings_report | ip_type, date_from, date_to | Report on recent filings in a period |
Tool execution errors (API failures, timeouts, missing credentials) are returned with MCP isError: true and a masked, user-friendly message — internal details (stack traces, raw API bodies) go only to the server log. A specific number lookup that finds nothing is not an error: it returns a normal result with match_type: "none" and a message.
This server is in Phase 1 (read-only) of the MCP phased-rollout model: every tool is read-only and writes nothing. See ROADMAP.md for the phase plan and the prerequisites for any future write-capable phase.
AI client (Claude Desktop, Cursor, VS Code + Continue, …)
│ │ MCP (stdio or SSE) ▼ swiss-ip-mcp │ │ HTTPS + OAuth2 (IGE IDP) ▼ Swissreg Datadelivery API https://www.swissreg.ch/public/api/v1 │ ├── TrademarkSearch ├── PatentSearch ├── PatentPublicationSearch ├── SPCSearch └── UserQuota
| Transport | Use case | Configuration |
|---|---|---|
| stdio | Claude Desktop, local development | Default (no extra setup) |
| Streamable HTTP | Cloud deployment (Render.com etc.) | MCP_TRANSPORT=streamable-http |
| SSE | Legacy HTTP clients — *deprecated* | MCP_TRANSPORT=sse |
SSE is deprecated. Protocol revision
2026-07-28reclassified the
HTTP+SSE transport as Deprecated under the feature lifecycle policy (SEP-2596;
it had been soft-deprecated since
2025-03-26). It stays available here for
the twelve-month deprecation window — new deployments should use
MCP_TRANSPORT=streamable-http.
Transport is selected at startup from the MCP_TRANSPORT environment variable (default stdio). The HTTP transports are served by uvicorn and honour:
| Variable | Default | Purpose |
|---|---|---|
MCP_HOST | 127.0.0.1 | Bind address. Use 0.0.0.0 only inside a container / behind a reverse proxy. |
PORT / MCP_PORT | 8000 | Bind port (PORT wins — PaaS convention). |
MCP_ALLOWED_ORIGINS | _(empty)_ | Comma-separated CORS origin allow-list. No wildcard in production. |
MCP_ALLOWED_HOSTS | _(empty)_ | Comma-separated Host-header allow-list; enables DNS-rebinding protection when set. |
The Mcp-Session-Id header is exposed via CORS so browser-based clients can read and echo it on follow-up requests.
pip# Run directly with uv (recommended, no local installation needed)
uvx swiss-ip-mcp
git clone https://github.com/malkreide/swiss-ip-mcp cd swiss-ip-mcp pip install -e ".[dev]"
export IGE_USERNAME="your_username"
export IGE_PASSWORD="your_password"
Open the config file:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": { "swiss-ip": { "command": "uvx", "args": ["swiss-ip-mcp"], "env": { "IGE_USERNAME": "your_username", "IGE_PASSWORD": "your_password" } } } }
swiss-ip-mcp is compatible with any MCP-capable client:
| Client | Configuration |
|---|---|
| Cursor | Add to ~/.cursor/mcp.json (same format as Claude Desktop) |
| VS Code + Continue | Add via continue.json MCP server block |
| Windsurf | Add via MCP server settings |
| Self-hosted (mcp-proxy) | Use SSE transport with MCP_TRANSPORT=sse |
MCP_TRANSPORT=streamable-http \
MCP_HOST=0.0.0.0 PORT=8000 \ MCP_ALLOWED_ORIGINS="https://your-client.example" \ MCP_ALLOWED_HOSTS="your-app.onrender.com" \ IGE_USERNAME=... IGE_PASSWORD=... \ swiss-ip-mcp
Security note: bind to
0.0.0.0only inside a container or behind a
reverse proxy. Always set
MCP_ALLOWED_ORIGINSandMCP_ALLOWED_HOSTSfor
public deployments — this enables CORS scoping and DNS-rebinding protection.
The endpoint is unauthenticated and serves only public IP-register data; do
not place credentialed or non-public tools behind this transport without
adding authentication first.
A hardened multi-stage Dockerfile (non-root UID 10001, HEALTHCHECK on /health), a docker-compose.yml with resource limits, and Kubernetes manifests + an HAProxy sticky-session config under deploy/ are included.
docker compose up --build # reads IGE_* from .env
See docs/deployment.md for hardening, resource limits and scaling (stateless vs. sticky-session) details.
# Unit tests (no credentials needed)
PYTHONPATH=src pytest tests/ -v
IGE_USERNAME=... IGE_PASSWORD=... PYTHONPATH=src pytest tests/ -v
The CI workflow runs on Python 3.11, 3.12, and 3.13.
The server can emit OpenTelemetry traces — one span per tool call plus child spans for the backend Swissreg/IDP HTTP calls. Tracing is off by default and adds no overhead until enabled.
pip install 'swiss-ip-mcp[otel]'
MCP_OTEL_ENABLED=1 \ OTEL_EXPORTER_OTLP_ENDPOINT=http://your-collector:4318 \ MCP_ENV=production \ swiss-ip-mcp
| Variable | Purpose |
|---|---|
MCP_OTEL_ENABLED | Set to 1 to enable trace export (or just set the endpoint below). |
OTEL_EXPORTER_OTLP_ENDPOINT | OTLP/HTTP collector endpoint (standard OTEL variable). |
MCP_ENV | Value for the deployment.environment resource attribute (default production). |
Tool spans carry only mcp.tool.name and mcp.tool.result.is_error — no query arguments, credentials or response bodies are recorded.
The server logs structured JSON to stderr (stdout is reserved for the stdio protocol). Every tool call binds a tool name and a correlation_id, so all log lines for one call are correlated. Set the level with LOG_LEVEL (DEBUG / INFO / WARNING / ERROR, default INFO):
{"event": "tool.call.start", "tool": "swiss_ip_search_trademarks", "correlation_id": "da55…", "level": "info", "timestamp": "…Z"}
This server speaks two protocol eras over the same endpoint. The client's first request on a connection decides which one applies; a later claim from the other era is refused.
| Era | Revision | Who reaches it |
|---|---|---|
initialize handshake | 2024-11-05 … `2025-11-25` | What today's clients speak. The server answers with the revision asked for, or with the 2025-11-25 ceiling when the request asks for something newer. |
| Per-request envelope | `2026-07-28` | A request carrying the 2026-07-28 _meta envelope opens a modern connection. |
Both revisions are pinned in tests/test_protocol_version.py and asserted against the installed SDK, so a Dependabot bump of mcp cannot move either one silently.
On top of that, tests/test_modern_era.py measures both eras: it sends re