Skip to content

Releases

skel-mcp v0.3.1

Choose a tag to compare

@encryptedbasic encryptedbasic released this 16 Nov 19:36

skel-mcp 0.3.1

skel-mcp gives coding agents focused source context through a local MCP server for TypeScript, JavaScript, Python, and Go.

What's new since 0.2.0

  • Request detail: "returns" to retrieve a function's explicit returns or the expression of an expression-bodied arrow. Nested callables are excluded. The full symbol view is available when the task needs branch conditions or the implementation.
  • Set contextLines: 0 to get exact matching lines. Request up to five lines of surrounding context when needed.
  • Filter unstaged Git changes by an exact file path or symbol, with the option to retrieve complete affected bodies.
  • Provide a shared file for a batch and set sources: true to label results with workspace-relative paths and symbol names.
  • Resolve linked TypeScript types within the configured workspace. Python import filtering retains references from simple quoted type annotations.

Token usage in Codex CLI

Codex CLI benchmark token totals

Benchmark using skel-mcp 0.2.0 Without MCP With skel-mcp Fewer tokens
Six separate tasks 212,180 149,252 29.7%
The same six tasks in one request 41,966 26,216 37.5%

Each row comes from one paired Codex CLI trial with matching prompts and verified answers. Totals include model input and output. The MCP runs used direct tool routing. The baseline read whole files and used plain Git diffs. Results vary by workload and client configuration. Six-task report · Batch report

Install

Use Node.js 20 or later. Once the npm version is available, run the server over stdio from the project you want to analyze.

npx --yes skel-mcp@0.3.1

You can also run the attached package directly.

npx --yes --package=https://github.com/encryptedbasic/skel-mcp/releases/download/v0.3.1/skel-mcp-0.3.1.tgz skel-mcp

Client setup · Package archive · Download chart

skel-mcp v0.2.0

Choose a tag to compare

@encryptedbasic encryptedbasic released this 14 Nov 13:29

skel-mcp v0.2.0

Get the code an agent needs in one MCP call. This release makes get_context the default interface for TypeScript, JavaScript, Python, and Go.

Launch directly from this GitHub Release archive.

npx --yes --package=https://github.com/encryptedbasic/skel-mcp/releases/download/v0.2.0/skel-mcp-0.2.0.tgz skel-mcp

Install from the npm registry with:

npx --yes skel-mcp@0.2.0

Use Node.js 20 or later. Install Git to use the diff operation. The server runs locally over stdio. See the setup guide for Claude Code, Cursor, Codex, and VS Code.

What's new

  • get_context batches up to 20 requests for names, signatures, full symbols, selected lines, or AST-aware diffs.
  • Symbol responses include relevant imports and related type declarations. TypeScript and JavaScript can follow an unambiguous relative import one step within the workspace. Python and Go resolve declarations in the source file.
  • Responses start with a 1,200-token page and include a continuation cursor when more content is available. Set maxTokens: null for the full response. Use detail: "full" on a diff request for complete affected implementations.
  • Source reads are scoped to the configured workspace. The server rejects paths outside the project and paths to Git metadata.
  • Start the server with --legacy to use get_file_skeleton, get_symbol, and get_smart_diff.

Benchmark

Codex CLI benchmark token totals

Scenario Without MCP With skel-mcp Fewer tokens
Six separate tasks 212,180 149,252 29.7%
The same six tasks in one batch 41,966 26,216 37.5%

The saved experiment measured total input plus output tokens in Codex CLI with direct MCP tool routing. It ran one paired trial per scenario, and all reference answers matched. The baseline used full-file reads or ordinary Git diffs. Both arms of the batch experiment retrieved their context in one call. Results depend on the workload and the client's tool configuration. Six-task report · Batch report