CCDB Connect MCP server with authenticated factor search and details
Two tools with complete input/output schemas and tool annotations. Descriptions are present and substantive (150-200 chars), written in Chinese with clear guidance on usage constraints. Both tools properly declare readOnlyHint=true and idempotentHint=true. Input schemas use Zod validation with proper typing. However, descriptions lack English translations for non-Chinese speakers, and parameter descriptions within schemas could be more explicit about constraints (e.g., limit bounds, filter semantics). Error handling is structured via toolErrorSchema but lacks recovery guidance in descriptions.
用搜索返回的字符串 factorId 获取完整 CCDB 详情、单位、来源和适用范围。保留所有扩展字段及受限值;回答后以返回的 detailUrl 提供"在 Carbon Agent 查看该因子"链接。数值受限时说明限制,不承诺登录或注册后解锁。
按具体关键词和可选地区、年份、来源条件检索 CCDB 候选因子。候选不是最终推荐;使用因子时核对详情。回答中每个展示的因子名称都应以返回的 detailUrl 提供可点击链接,比较表各行也保留链接,不只输出 ID。缺失链接不编造。不能全库遍历。
Descriptions are Chinese-only; no English fallback for international LLM agents. Reduces discoverability and usability in non-Chinese contexts.
Parameter descriptions in schemas lack explicit constraints. 'limit' has no min/max bounds; 'filters' object properties lack descriptions; 'sourceLevel' enum values not documented.
Error handling returns structured errors but descriptions do not guide recovery. E.g., 'ECOINVENT_VALUE_RESTRICTED' is mentioned in instructions but not in tool descriptions, forcing LLMs to infer handling.
Output schemas use .partial() and optional error field, but no documentation of when errors occur vs. partial results. LLMs cannot distinguish retryable from fatal failures.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | 2026-07-28+ | v2 |
search_emission_factors accepts 'limit' parameter but no pagination (offset/cursor) documented. Large result sets may exceed context window; no guidance on result capping.