星图 XingTu - 多模态 Agent 数据库的 MCP 协议服务器。为 AI Agent 提供数据集合管理、文档操作、向量搜索、文件导入等能力。
18 tools with mixed quality. Most have descriptions (Chinese, 50-150 chars), but parameter documentation is sparse. Input schemas present for all tools but lack depth: many parameters missing type constraints, enums, or validation guidance. No output schemas documented. Error handling absent. Tool names follow verb_noun pattern (xingtu_*) but descriptions don't explain WHEN to use each tool vs. alternatives (e.g., query_documents vs. text_search distinction unclear). Batch operations (batch_get_documents) exist but single-item variants also present, creating composition ambiguity. No security annotations (destructiveHint, readOnlyHint) despite destructive operations (delete_collection, delete_documents). Ingest tools (ingest_file, ingest_excel, ingest_database) lack error recovery guidance.
向集合添加文档(自动生成嵌入向量)。支持自定义 ID:传入 document_ids 与 texts 一一对应,玄武可用 ki-xxx 作为共享键。不传则自动生成 UUID。
批量获取文档 — 按 ID 列表一次性拉回元数据。高效替代逐条 get_document,适合玄武按 ID 批量拉取元数据。缺失的 ID 静默跳过。
创建数据集合(同名幂等,返回已有集合)。
删除集合及其所有文档。
删除文档。
获取集合详情。
获取文档详情。
No output schemas documented. LLMs cannot infer what fields to expect from tool responses, forcing them to guess at downstream field names and risk broken tool chains.
Destructive operations (delete_collection, delete_documents) lack error handling guidance and confirmation patterns. No dry-run or confirmation step to prevent accidental data loss.
Parameter descriptions lack validation constraints. E.g., 'limit' and 'offset' have no min/max bounds; 'threshold' (0-1) is documented but others are not. LLMs will pass invalid values without guidance.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 49 | <=2025-11-25 | v2 |
获取系统统计信息。
获取完整的世界模型上下文 — 所有已发布的集合、文档和关系。
图像搜索 — 按图像内容搜索相似文档。
从数据库导入查询结果到星图。执行 SQL 查询,每行结果生成一个文档。支持 SQLite(内置)和 SQLAlchemy 支持的所有数据库(PostgreSQL、MySQL 等)。
导入 Excel 文件(.xlsx / .xls)到星图。每行生成一个文档,整行数据保留在 metadata_json。需要 openpyxl: pip install 'xingtu[excel]'
导入文件到星图(支持 CSV、Excel、JSON、PDF、TXT、图片)。
列出所有数据集合。
结构化过滤查询文档 — 按 tag、metadata、时间范围等条件过滤。替代 text_search 用于结构化元数据查询。例如查找所有 domain=ai_research 的文档。
向量搜索 — 按文本内容搜索相似文档。
更新集合信息。
更新文档信息。
Ingest tools (ingest_file, ingest_excel, ingest_database) lack error recovery guidance. No indication of which errors are retryable, which require user intervention, or what to do if parsing fails.
Tool annotations missing. No readOnlyHint, destructiveHint, or idempotentHint tags. LLMs cannot determine which tools are safe to retry or which modify state without reading descriptions.