Repository navigation
Releases
skel-mcp v0.3.1
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: 0to 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
filefor a batch and setsources: trueto 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
| 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.1You 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-mcpskel-mcp v0.2.0
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-mcpInstall from the npm registry with:
npx --yes skel-mcp@0.2.0Use 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_contextbatches 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: nullfor the full response. Usedetail: "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
--legacyto useget_file_skeleton,get_symbol, andget_smart_diff.
Benchmark
| 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