Skip to content

Commit 6c30a75

Browse files
jqnatividadclaude
andcommitted
feat(mcp): add operation timeout guidance to server instructions
Agents in Claude Cowork were timing out at 30 seconds when calling qsv MCP tools. Add OPERATION TIMEOUT section to DEFAULT_SERVER_INSTRUCTIONS so agents know the server supports up to 10 minutes (configurable to 30) and should not use shorter client-side timeouts. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent f5262a5 commit 6c30a75

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

.claude/skills/src/mcp-server.ts

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,9 @@ FILE HANDLING: Save outputs to files with descriptive names rather than returnin
7575
7676
TOOL COMPOSITION: qsv_sqlp auto-converts CSV inputs to Parquet, then routes to DuckDB when available for better SQL compatibility and performance; falls back to Polars SQL otherwise. For multi-file SQL queries, convert all files to Parquet first with qsv_to_parquet, then use read_parquet() references in SQL. For custom row-level logic, use qsv_command with command="luau".
7777
78-
MEMORY LIMITS: Commands dedup, sort, reverse, table, transpose, pragmastat load entire files into memory. For files >1GB, prefer extdedup/extsort alternatives via qsv_command. Check column cardinality with qsv_stats before running frequency or pivotp to avoid huge output.`;
78+
MEMORY LIMITS: Commands dedup, sort, reverse, table, transpose, pragmastat load entire files into memory. For files >1GB, prefer extdedup/extsort alternatives via qsv_command. Check column cardinality with qsv_stats before running frequency or pivotp to avoid huge output.
79+
80+
OPERATION TIMEOUT: qsv operations can take significant time, especially on larger files. The MCP server's default operation timeout is 10 minutes (configurable via QSV_MCP_OPERATION_TIMEOUT_MS, max 30 minutes). Do NOT use a shorter client-side timeout — allow operations to run to completion or until the server's configured timeout. Check the current timeout setting with qsv_config.`;
7981

8082
/**
8183
* Resolved server instructions: uses custom instructions from

0 commit comments

Comments
 (0)