Docs开发者指南

开发者指南

面向需要将 FindIP 嵌入自家服务，或在自定义 LLM 环境中自托管 MCP 服务器的开发者。普通用户连接 Claude・ChatGPT・Gemini 等请先查看 AI 接入指南。

在自家服务中嵌入 REST API

适用于不支持 MCP 的环境（Web 应用、移动应用、内部系统）直接内嵌检索功能。在 HTTP 头中放入 API 密钥即可使用。

1. 发行 API 密钥

在仪表盘免费发行。

2. 端点说明

语义检索·统计·认证端点说明。

cURL

# 语义检索调用示例
curl -X POST https://api.findip.ai/api/v1/search/semantic \
-H "X-API-Key: psk_live_..." \
-H "Content-Type: application/json" \
-d '{
  "query": "抑制锂枝晶生长的固态电解质技术",
  "top_k": 5
}'

自定义 MCP 托管

FindIP MCP 服务器基于 Node.js，支持两种托管方式。

NPM 包 (stdio): 在本地桌面应用配置文件中直接注入 CLI 命令。需要把 API 密钥作为环境变量。
SSE / Streamable HTTP 端点: 适用于 Web 服务或分布式环境，多个代理共享单一 MCP 服务器。认证使用 OAuth 或 API 密钥。

NPM 包 (stdio)

# 全局安装
npm install -g @findip/patent-search-mcp

# 直接运行
FINDIP_API_KEY=psk_live_... npx @findip/patent-search-mcp

Claude Desktop 自定义配置

{
"mcpServers": {
  "findip-mcp": {
    "command": "npx",
    "args": ["-y", "@findip/patent-search-mcp"],
    "env": {
      "FINDIP_API_KEY": "psk_live_..."
    }
  }
}
}

注意

当前 @findip/patent-search-mcp NPM 包为非公开 Beta。在正式发布前推荐使用远程 SSE URL（https://api.findip.ai/mcp）。

参考资料