{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_4ny2f4gb4p9x","handle":"vinehoo-vector-products-search-mcp","url":"https://wellknown.network/agents/vinehoo-vector-products-search-mcp","links":{"self":"https://wellknown.network/agents/vinehoo-vector-products-search-mcp/record.json","html":"https://wellknown.network/agents/vinehoo-vector-products-search-mcp","markdown":"https://wellknown.network/agents/vinehoo-vector-products-search-mcp/record.md","api":"https://wellknown.network/api/v1/agents/vinehoo-vector-products-search-mcp","status":"https://wellknown.network/api/v1/agents/vinehoo-vector-products-search-mcp/status","claim":"https://wellknown.network/agents/vinehoo-vector-products-search-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/vinehoo-vector-products-search-mcp/claim.json","badge":"https://wellknown.network/agents/vinehoo-vector-products-search-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:vinehoo-vector-products-search-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"vinehoo-vector-products-search-mcp","summary":"VikingDB Multi-modal Search MCP Server using FastMCP","description":"# VikingDB Multi-modal Search MCP Server\n\n这是一个使用 Python FastMCP 框架开发的 MCP Server，用于在火山引擎 VikingDB 向量数据库中进行多模态检索。\n\n## 功能介绍\n\n提供 `search_multi_modal` 工具，支持：\n- 文本搜索\n- 图片搜索 (TOS 或 HTTP 链接)\n- 视频搜索 (TOS 或 HTTP 链接)\n- 多模态组合搜索\n\n## 安装依赖\n\n```bash\npip install -r requirements.txt\n```\n\n## 配置\n\n复制 `.env.example` 为 `.env` 并填入您的火山引擎凭证：\n\n```bash\ncp .env.example .env\n```\n\n并在 `.env` 中设置以下变量：\n- `VOLC_AK`: 火山引擎 Access Key\n- `VOLC_SK`: 火山引擎 Secret Key\n- `VIKINGDB_HOST`: VikingDB 域名 (默认: api-vikingdb.vikingdb.cn-beijing.volces.com)\n- `VIKINGDB_REGION`: 区域 (默认: cn-beijing)\n\n## 运行\n\n```bash\npython server.py\n```\n\n## MCP 工具说明\n\n### `search_multi_modal`\n\n参数：\n- `collection_name` (str): 集合名称\n- `index_name` (str): 索引名称\n- `text` (str, 可选): 检索文本\n- `image` (str, 可选): 图片链接\n- `video_url` (str, 可选): 视频链接\n- `video_fps` (float, 可选): 视频采样频率\n- `need_instruction` (bool): 是否启用 Instruction (默认为 True)\n- `output_fields` (list, 可选): 返回字段列表\n- `limit` (int): 返回结果数量 (默认 10)\n\n## 发布到 PyPI\n\n如果您希望将此项目发布到 PyPI，可以使用我们提供的自动化脚本：\n\n1. **安装必要工具**（仅需一次）：\n   ```bash\n   pip install build twine\n   ```\n\n2. **运行发布脚本**：\n   ```bash\n   ./publish.sh\n   ```\n\n   该脚本会自动执行以下步骤：\n   - 检查当前版本并**建议/手动确认**新版本。\n   - 自动更新 `pyproject.toml`。\n   - 清理旧的构建文件。\n   - 构建新的分发包。\n   - 调用 `twine` 上传至 PyPI。\n\n   > **注意**：在上传时，您需要输入 PyPI 的 API Token。建议提前在 `~/.pypirc` 中配置好 Token 以实现完全自动化。\n\n## 本地开发安装\n\n可以使用开发模式安装，以便直接运行命令：\n\n```bash\npip install -e .\nvinehoo-search\n```","publisher":null,"homepage":"https://github.com/vber/vinehoo-vector-products-search-mcp","repository":"https://github.com/vber/vinehoo-vector-products-search-mcp/issues","version":"0.1.6","license":null,"protocols":["mcp"],"tags":["mcp","vector-search","vikingdb","vinehoo","volcengine"],"pricing":null,"endpoints":[{"url":"pypi:vinehoo-vector-products-search-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.vector-search","name":"Vector Search","confidence":1,"provenance":"declared"},{"slug":"commerce.ecommerce","name":"E-commerce Operations","confidence":0.75,"provenance":"derived"}],"categories":["commerce","data"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"vinehoo-vector-products-search-mcp","registry":"pypi","observedAt":"2026-09-10T15:25:13.097Z","publishedAt":"2026-01-14T07:31:18.870542Z","latestVersion":"0.1.6"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"vinehoo-vector-products-search-mcp","url":"https://pypi.org/project/vinehoo-vector-products-search-mcp/","firstSeenAt":"2026-09-10T15:23:39.002Z","fetchedAt":"2026-09-10T15:23:39.002Z","normalizedAt":"2026-09-10T15:23:39.002Z"}]},"firstSeenAt":"2026-09-10T15:23:39.002Z","updatedAt":"2026-09-10T15:25:13.097Z"}