IP-MCP

将日本特许厅“专利信息获取 API” (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 操作指南（不可逾越的设计规则、JPO API 的陷阱）

占位符替换说明

由于本仓库为公开仓库，部署目标的局域网 IP 和 SSH 用户名已替换为占位符。拉取代码后，请根据您的环境进行替换。

占位符	示例	设置方法
`<DEPLOY_HOST>`	`192.0.2.10`	部署目标服务器的局域网 IP
`<SSH_USER>`	`alice`	服务器的 SSH 用户名

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" }
    }
  }
}

重要设计规则

官方 JPO API 工具 (jpo_*) 与外部搜索工具 (external_*) 完全分离。不进行自动回退。
详情请参阅 PLAN.md §2.5 和 CLAUDE.md。

许可证

MIT

This server cannot be installed

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

IP-MCP

IP-MCP

文档

占位符替换说明

快速入门

本地开发

部署 (<DEPLOY_HOST>)

Claude Desktop / Code 连接

重要设计规则

许可证

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API