AI导哈

Weaviate MCP HTTP服务器

Weaviate MCP HTTP服务器是一个用于连接Weaviate云和远程MCP客户端的服务，支持快速部署和多种搜索功能。

  • by cienco
  • Python
  • 云端部署
  • 更新于
在 GitHub 查看 cienco/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/)
  4. 部署。
  5. 检查 ： GET https://<service>.onrender.com/health → {"status":"ok",...}.

通过Claude连接（远程MCP）

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

https://<service>.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小时。

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

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

    Curl的例子：

    curl -X POST https://<service>.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。

相关 MCP