IP-MCP

Stellt die „Patentinformations-Abruf-API“ des japanischen Patentamts (https://ip-data.jpo.go.jp) als MCP-Server bereit, um Patentinformationen über Claude Desktop / Claude Code mittels natürlicher Sprache abrufen zu können.

Nur für die Bereitstellung im LAN (<DEPLOY_HOST>:8765). Python 3.12 + FastMCP + httpx, dauerhaft ausgeführt via Docker Compose.

Dokumentation

• PLAN.md — Entwurfsplan (Architektur, Liste aller Tools, Phasenplan)

• CLAUDE.md — Bedienungsanleitung für Claude Code (unveränderliche Designregeln, Fallstricke der JPO-API)

Ersetzung von Platzhaltern

Da dieses Repository öffentlich ist, wurden die LAN-IP des Bereitstellungsziels und der SSH-Benutzername durch Platzhalter ersetzt. Wer das Repository pullt, sollte diese entsprechend seiner eigenen Umgebung anpassen.

Die Port-Bindung in der docker-compose.yml ist standardmäßig auf 127.0.0.1:8765 eingestellt (= nur vom selben Rechner aus). Wenn Sie den Zugriff im LAN freigeben möchten, erstellen Sie bitte eine separate docker-compose.override.yml (bereits in .gitignore enthalten) und überschreiben Sie diese. Beispiel:

# docker-compose.override.yml (commit しない)
services:
  ip-mcp:
    ports:
      - "192.0.2.10:8765:8765"   # 自分の LAN IP に置き換え

Schnellstart

Lokale Entwicklung

cp .env.example .env          # JPO_USERNAME / JPO_PASSWORD を記入
chmod 600 .env
docker compose up -d --build
curl http://127.0.0.1:8765/healthz

Bereitstellung (<DEPLOY_HOST>)

ssh <SSH_USER>@<DEPLOY_HOST> "mkdir -p ~/ip-mcp"
git clone https://github.com/kitepon-rgb/IP-MCP.git ~/ip-mcp     # 初回のみ
ssh <SSH_USER>@<DEPLOY_HOST> "cd ~/ip-mcp && git pull && docker compose up -d --build"

Verbindung zu Claude Desktop / Code

{
  "mcpServers": {
    "ip-mcp": {
      "transport": { "type": "sse", "url": "http://<DEPLOY_HOST>:8765/sse" }
    }
  }
}

Wichtige Designregeln

• Offizielle JPO-API-Tools (jpo_*) und externe Suchtools (external_*) sind strikt voneinander getrennt. Kein automatisches Fallback.

• Details finden Sie unter PLAN.md §2.5 und CLAUDE.md.

Lizenz

MIT