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)

Related MCP server: MCP-ndl-search

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