IP-MCP

Предоставляет «API получения патентной информации» Японского патентного ведомства (JPO) (https://ip-data.jpo.go.jp) в качестве MCP-сервера, позволяя запрашивать патентную информацию на естественном языке из Claude Desktop / Claude Code.

Предназначен только для развертывания в локальной сети (<DEPLOY_HOST>:8765). Работает на Python 3.12 + FastMCP + httpx, постоянно запущен через Docker Compose.

Документация

• PLAN.md — План проектирования (архитектура, список всех инструментов, поэтапный план)

• CLAUDE.md — Руководство по эксплуатации для Claude Code (незыблемые правила проектирования, ловушки API JPO)

Замена заполнителей

Поскольку этот репозиторий является публичным, IP-адрес локальной сети и имя пользователя SSH для развертывания заменены заполнителями. После выполнения pull, пожалуйста, замените их в соответствии с вашей средой.

Привязка порта в docker-compose.yml по умолчанию установлена на 127.0.0.1:8765 (= только с той же машины). Если вы хотите открыть доступ в локальной сети, создайте отдельный файл docker-compose.override.yml (уже добавлен в .gitignore) и переопределите настройки. Пример:

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

Быстрый старт

Локальная разработка

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

Развертывание (<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"

Подключение Claude Desktop / Code

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

Важные правила проектирования

• Официальные инструменты API JPO (jpo_*) и инструменты внешнего поиска (external_*) полностью разделены. Автоматический откат (fallback) не выполняется.

• Подробности см. в PLAN.md §2.5 и CLAUDE.md.

Лицензия

MIT