imagedata

imagedata

imagedata 是一个小型本地桥接服务，连接托管的 HasData Google Images MCP 服务，该服务以 JSON 格式返回 Google Images 搜索结果。提供查询词后，它会获取该查询的图片结果：每张图片的标题、 图片所在页面、图片直链、缩略图、尺寸、来源名称以及在结果中的 位置。可以使用 tbs 筛选字符串（图片尺寸、主色调以及人脸、照片、剪贴画、线稿 或动画等图片类型）、安全搜索、相似结果／省略结果 筛选开关、Google 域名、国家和语言 代码、规范化或编码后的位置、设备类型以及基于页码的分页来调整搜索。

该桥接服务本身不存储任何结果。它会在本地提供上游服务的工具列表， 内容与从实时端点捕获的完全一致，并将每次 工具调用转发到上游，原样返回结果。 捕获到的接口仅包含一个只读查询： 没有写入、消息传递或支付工具。

工具

• hasdata_google_images_images_getImageSearchResults — 获取一页 Google Images 搜索结果。必填参数： q（搜索词）。可选参数：location（Google 规范化位置）、uule（编码后的位置 参数）、domain（要使用的 Google 域名， 例如 google.com）、gl（两个字母的国家代码）、 hl（两个字母的语言代码）、tbs（筛选字符串， 可组合尺寸筛选条件，例如 isz:l、颜色筛选条件，例如 ic:color，以及类型筛选条件，例如 itp:photo）、safe（active / off）、 filter（1 或 0：相似结果／省略结果筛选）、deviceType（desktop / mobile / tablet），以及 ijn（页码，0 表示第一页）。返回每张图片的标题、来源页面 URL、图片直链、 缩略图、尺寸、来源名称和 位置。

配置

• HASDATA_GOOGLE_IMAGES_MCP_URL（可选）— 覆盖 上游端点。默认值为 https://mcp.hasdata.com/mcp?apis=google_images。 （此覆盖钩子是本次重建自行标注的内容。）
• HASDATA_API_KEY（可选）— 设置后，每个上游请求都会携带 x-api-key: <key> 标头，使用调用者自己的 HasData API 密钥。未设置时，不会发送密钥标头。（标头名称 和环境变量名称由原始项目的注册表记录确定；从此环境 变量转发密钥是本次重建自行标注的内容——原始接口是在不带密钥的情况下捕获的。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话：发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26， clientInfo 名称为 imagedata），然后发送 notifications/initialized 通知，最后发送携带调用者参数且未作任何更改的 tools/call 请求。上游在 initialize 响应中返回 Mcp-Session-Id 标头时，该值会随会话的每个后续请求发送；会话会在 进程运行期间重复使用。响应可能以普通 JSON 或服务器发送事件的形式返回；两种格式都会读取。

成功的上游结果会原样传递，包括上游设置的任何 isError 标志。 失败情况——JSON-RPC 错误、非 2xx 状态、无法读取的响应或 无法完成的请求——都会作为 isError 结果返回，且文本以 imagedata error: 开头（此错误呈现方式是本次重建自行标注的内容）。

命令行

该工具也可作为子命令使用，接收一个 JSON 参数字符串：

npx @reneturcios/imagedata hasdata_google_images_images_getImageSearchResults '{"q":"golden retriever puppies","tbs":"isz:l,ic:color,itp:photo","safe":"active"}'
npx @reneturcios/imagedata --version

退出码：成功时为 0，结果为 isError 时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/imagedata mcp

MCP 客户端配置：

{
  "mcpServers": {
    "imagedata": {
      "command": "npx",
      "args": ["-y", "@reneturcios/imagedata", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/imagedata
docker run --rm ghcr.io/cloudcorprecords/imagedata --version

容器的默认命令是 mcp，因此第一种形式会启动 stdio MCP 服务；其他参数则按常规方式传递给命令行工具。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全针对桩接的 JSON-RPC 上游运行，不会进行实时网络调用。

许可证

MIT — 参见 LICENSE。