A Model Context Protocol server for Lark (飞书) - provides tools for creating and managing Lark spreadsheets and controlling access permissions
Single tool 'addToLarkSheet' has critical definition gaps. Tool name lacks action clarity (should be 'create_lark_sheet' or 'write_to_lark_sheet'). Description is present but mixes Chinese and English, making it ambiguous for LLM parsing. Input schema exists with types (string) but parameter descriptions are overly verbose, include example values (anti-pattern), and lack constraint documentation. No output schema documented, tool returns TextContent with raw URL string, no structured fields. No error handling guidance. Tool combines multiple concerns (create sheet, write data, add permissions) violating single-responsibility principle.
创建飞书表格,并将数据写入到飞书表格中 参数: title: 飞书表格名称,如:人口统计表 data: 需要写入的数据,一个二维数组字符串,第一行是表格的表头,剩下的为具体数据内容。如:"[['市区', '人口数量', '占比'],['成都', 100000, '20%'], ['背景', 150000, '25%']]" hasAccessEmail: 需要添加表格权限的邮箱。比如:aaa.163.com 返回: 飞书表格的地址
Tool name 'addToLarkSheet' lacks action verb clarity. Should be 'create_lark_sheet' or 'write_to_lark_sheet' to signal intent. Current name is ambiguous about whether it creates, updates, or appends.
Parameter descriptions include example values (anti-pattern). LLMs reuse examples literally: 'aaa.163.com' and '背景' will be passed as real data. Replace with formal constraints (regex, enum, format).
No output schema documented. Tool returns TextContent with raw URL string. LLMs cannot plan downstream operations. Should return structured object: {url: string, spreadsheet_token: string, sheet_id: string}.
Tool combines three distinct operations: create sheet, write data, add permissions. Violates single-responsibility. Should split into create_lark_sheet, append_lark_sheet_data, grant_lark_sheet_access.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 38 | 2026-07-28+ | v2 |
No error handling guidance. If sheet creation fails, data write fails, or permission grant fails, tool returns raw error string. LLM has no recovery path. Should categorize errors (retryable vs user-fixable) and suggest next steps.