IP-MCP

Expone la "API de obtención de información de patentes" de la Oficina de Patentes de Japón (https://ip-data.jpo.go.jp) como un servidor MCP, permitiendo consultar información de patentes mediante lenguaje natural desde Claude Desktop / Claude Code.

Solo para despliegue en LAN (<DEPLOY_HOST>:8765). Python 3.12 + FastMCP + httpx, residente mediante Docker Compose.

Documentación

• PLAN.md — Plan de diseño (arquitectura, lista completa de herramientas, plan por etapas)

• CLAUDE.md — Guía de operación para Claude Code (reglas de diseño innegociables, trampas de la API de la JPO)

Sustitución de marcadores de posición

Dado que este repositorio es público, la IP de la LAN de destino y el nombre de usuario SSH se han convertido en marcadores de posición. Quienes hagan pull deben reemplazarlos según su propio entorno.

El enlace de puerto en docker-compose.yml es por defecto 127.0.0.1:8765 (= solo desde la misma máquina). Si desea exponerlo en la LAN, cree un docker-compose.override.yml por separado (ya incluido en .gitignore) y sobrescríbalo. Ejemplo:

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

Inicio rápido

Desarrollo local

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

Despliegue (<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"

Conexión con Claude Desktop / Code

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

Reglas importantes de diseño

• Las herramientas oficiales de la API de la JPO (jpo_*) y las herramientas de búsqueda externa (external_*) están completamente separadas. No hay respaldo automático (fallback).

• Para más detalles, consulte PLAN.md §2.5 y CLAUDE.md.

Licencia

MIT