Repository navigation
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-mcp