Weaviate MCP Render

编织MCP服务器（HTTP）——渲染就绪

每个collegare的服务器MCP HTTP（流式HTTP） 编织云 客户端MCP远程（例如克劳德）。

快速部署到 Render

1. 创建一个新的 Web服务 在此仓库/文件夹中的 Render 上。
2. （Con DockerfileRender将使用已经准备好的容器。
3. 设置环境变量 ：

- WEAVIATE_URL （或 WEAVIATE_CLUSTER_URL) - WEAVIATE_API_KEY - （备注） MCP_PATH （默认值 /mcp/)

1. 部署。
2. 检查 ： GET https://.onrender.com/health → {"status":"ok",...}.

通过Claude连接（远程MCP）

添加一个 自定义/远程MCP服务器 con URL:

https://.onrender.com/mcp/

并使用工具：

• get_config
• check_connection
• list_collections
• get_schema(collection)
• keyword_search(collection, query, limit)
• semantic_search(collection, query, limit)
• hybrid_search(collection, query, alpha, limit, query_properties, image_id, image_url, image_b64)
• upload_image(image_url, image_path, image_b64) - 上传图像并返回一个 image_id 用于 hybrid_search 哦 image_search_vertex
• image_search_vertex(collection, image_id, image_url, image_b64, caption, limit) - 矢量图像搜索

上传图片

服务器支持两种方式上传图像：

1. 工具MCP upload_image接受 image_url （最喜欢） image_path （服务器上的本地文件），或 image_b64返回一个 image_id 有效1小时。

1. 端点HTTP POST /upload-image为了直接上传二进制文件而不进行base64转换：

- 接受 multipart/form-data 匹配字段 image （文件binario） - 或 JSON 与 image_b64 - 还原 {"image_id": "...", "expires_in": 3600}

Curl的例子：

   curl -X POST https://.onrender.com/upload-image \
     -F "image=@/path/to/image.jpg"

Limage_id 返回可用于 hybrid_search 哦 image_search_vertex 以避免每次都要传递图像。

备注

• Weaviate 云 URL+neneneba API密钥.
• 服务器正在监听 0.0.0.0:$PORT （与Render兼容）
• 健康检查可在 /health.
• 您可以自定义服务器名称/描述/提示符：

- MCP_SERVER_NAME （默认值 weaviate-mcp-http) - MCP_DESCRIPTION 对于一个简短的描述 - MCP_PROMPT / MCP_INSTRUCTIONS 与客户端共享的文本提示符

• 或者，您可以将邮件版本化为文件，并使用以下方式对其进行定位：

- MCP_PROMPT_FILE 哦 MCP_INSTRUCTIONS_FILE （es。 prompts/instructions.md) - MCP_DESCRIPTION_FILE （es。 prompts/description.txt)

• 如果没有配置任何内容，服务器将自动加载默认提示符。 prompts/instructions.md.
• 工具 get_instructions 随时返回活动提示符。
• 美国 reload_instructions 在不重新启动服务器的情况下重新读取文件。

Vertex AI 认证

• 设置 VERTEX_APIKEY 如果您想使用静态密钥（没有刷新）。
• 或者，您可以通过设置已经通过OAuth获得的载体传递 VERTEX_BEARER_TOKEN.
• 对于自动刷新设置的 OAuth VERTEX_USE_OAUTH=true 并提供一个 服务账户:

- GOOGLE_APPLICATION_CREDENTIALS_JSON 用chiaro编写JSON 或 - GOOGLE_APPLICATION_CREDENTIALS 控制文件路径 或 - VERTEX_SA_PATH （默认值 /etc/secrets/weaviate-sa.json非常适合Render）。

• Vertex令牌每~55分钟重新生成一次，并插入REST标头（X-Goog-Vertex-Api-Key, Authorization)sia nei元数据gRPC。