Pike language MCP server with curated, runtime-verified knowledge base for AI code generation
Server provides 7 tools with complete input schemas and descriptions. Naming follows verb_noun convention (pike-evaluate, pike-check-syntax, pike-describe-symbol, pike-list-modules, pike-list-methods, pike-validate-example, pike-signature). All tools have descriptions (avg 120 chars, within 10-1024 range). All parameters are typed with Zod schemas and have descriptions. However, output schemas are not documented, responses are returned as text or JSON without explicit schema declarations. Error handling is basic (isError flag + text). No tool annotations (readOnlyHint/destructiveHint) despite clear risk levels (WRITE vs READ_ONLY). Parameter descriptions lack actionable constraints (e.g., timeout range 1-300 is declared but not explained in description text). Symbol validation regex is present but not documented in parameter descriptions.
Compile Pike code without executing. Uses compile_string which performs full compilation including constant evaluation. Returns compile errors if any.
Look up a Pike module, class, or function at runtime. Returns structured JSON with type, kind, and members.
Execute Pike code and return output. Code is written to a temp file and executed.
List methods/indices in a Pike class or module. Returns structured JSON.
List available Pike modules from the local Pike installation. Returns structured JSON.
Get the exact type signature of a Pike symbol. Returns structured JSON. More precise than pike-describe-symbol.
Output schemas not documented. Tools return pikeToolResponse() with text content, but LLMs cannot infer structure of JSON responses (e.g., pike-describe-symbol returns structured JSON but schema is not declared).
Tool annotations missing. pike-evaluate and pike-validate-example are destructive (WRITE risk), but no destructiveHint annotation. READ_ONLY tools lack readOnlyHint. Agents cannot distinguish safe from unsafe operations.
Parameter descriptions lack actionable constraints. Symbol validation regex /^[A-Za-z_][A-Za-z0-9_.]*$/ is enforced in code but not documented in parameter descriptions for pike-describe-symbol, pike-list-methods, pike-signature. LLMs cannot infer valid format.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 59 | 2026-07-28+ | v2 |
Validate a Pike code example by compiling and optionally running it. Returns PASS/FAIL.
Error handling is minimal. Errors return isError=true with text message, but do not categorize as retryable/user-fixable/fatal or provide recovery guidance. E.g., 'Symbol lookup failed' gives no actionable next step.
No confirmation/dry-run for destructive operations. pike-evaluate and pike-validate-example with run=true execute arbitrary code. No confirmation step or dry-run mode to prevent accidental execution.