IP-MCP

특허청 '특허 정보 취득 API'(https://ip-data.jpo.go.jp)를 MCP 서버로 공개하여 Claude Desktop / Claude Code에서 자연어로 특허 정보를 조회할 수 있게 합니다.

LAN 내 배포 전용 (<DEPLOY_HOST>:8765). Python 3.12 + FastMCP + httpx, Docker Compose로 상주 실행.

문서

• PLAN.md — 설계 계획서(아키텍처·전체 도구 목록·단계별 계획)

• CLAUDE.md — Claude Code용 조작 가이드(양보할 수 없는 설계 규칙·JPO API의 함정)

플레이스홀더 치환

이 저장소는 공개용이므로 배포 대상 LAN IP 및 SSH 사용자명은 플레이스홀더로 처리되어 있습니다. pull 하신 분은 자신의 환경에 맞게 수정해 주십시오.

docker-compose.yml의 포트 바인딩은 기본적으로 127.0.0.1:8765 (= 동일 머신에서만 접속 가능)입니다. LAN에 공개하려면 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" }
    }
  }
}

설계상 중요 규칙

• 공식 JPO API 도구 (jpo_*)와 외부 검색 도구 (external_*)는 완전히 분리합니다. 자동 폴백하지 않습니다.

• 자세한 내용은 PLAN.md §2.5 및 CLAUDE.md를 참조하십시오.

라이선스

MIT