Claude Token Saver MCP server

by BlackFoil·io.github.BlackFoil/claude-token-saver-mcp·v0.3.2·4 stars

No reviews yet

MCP server that offloads routine coding tasks to local LLM (Ollama) to save Claude API tokens

B75/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B75/100

full report

Adoption

New

4 stars63 downloads/wk

Reviews

Write one

Nobody has reviewed Claude Token Saver yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Claude Token Saver tools (11, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

auto_setup
Automate the full model setup flow: recommend the best model for a task category, download it if needed, and preload it into VRAM \u2014 all in one step.
batch_offloadwrite action
Submit multiple coding tasks as a batch to the local LLM. Tasks are processed sequentially or in parallel. Supports partial failure.
compress_context
Compress/summarize large text content using a local LLM to reduce cloud token usage. Use for summarizing logs, large files, or verbose context before sending to Claude.
configure_model_selector
View or modify model selector settings at runtime. Manage blocked models, license filters, and custom model recommendations.
cost_dashboard
View cumulative cost savings and model usage statistics.
get_metrics
Get server metrics in Prometheus text format or JSON. Includes request counts, latency, queue stats, cost savings, and health status.
list_loaded_models
List all models currently loaded in VRAM with usage details. Shows VRAM usage, expiry time, and available slots.
offload_work
Offload coding/text tasks to a local LLM (Ollama) to save Claude API tokens. Use for code generation, refactoring, formatting, boilerplate, and other routine tasks.
preload_model
Preload a model into VRAM for warm inference. Sends an empty chat request with keep_alive to keep the model loaded during the session.
pull_model
Download a model from the Ollama registry to local storage. Use this to install recommended models before preloading them into VRAM.
recommend_model
Recommend the best local LLM model for a given task category based on system specs and installed models. Returns prioritized list with installation status and license info.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

Code scan3 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 181 days ago4/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 75/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Claude Token Saver compares

Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 75/100; higher than 45% of 4,460 AI and agents servers
Tools: 11; the typical AI and agents server has 6
Tools that change things: 9%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 4; more than 77% of 2,711 AI and agents servers
Downloads a week: 63; more than 51% of 1,538 AI and agents servers with a package

What its tools let an agent do: 10 read · 1 change

Install Claude Token Saver in Claude Code, Cursor or VS Code

Runs npx -y claude-token-saver-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add claude-token-saver-mcp -- npx -y claude-token-saver-mcp

Add to Cursor

What the publisher says

From the Claude Token Saver repository's README, as published. We do not edit it. Read it on GitHub

English | 日本語

claude-token-saver-mcp

Beta — 個人利用向け。736 テスト / カバレッジ 97%。

Claude Code の「それ、ローカルでよくない？」を自動化する MCP サーバー。

ボイラープレート生成、テスト作成、テキスト要約 — Cloud API に投げるまでもない定型タスクを、手元の Ollama でさばきます。セキュリティ対策込み。

モチベーション

Claude Code の API 利用を分析してみたら、リクエストの約 40% は定型的なコード生成やテキスト処理でした。この手のタスクは 7B クラスのローカルモデルでも実用的な品質が出ます。「推論は Cloud、作業は Local」— この振り分けを MCP で自動化したのがこのツールです。

ローカル LLM はどこまで来たか

ローカル LLM の進化は速いです。2024 年の Llama 3 から 2025 年の Qwen3 まで、わずか 1 年でコード生成ベンチマーク (HumanEval) のスコアは 60% → 85% に跳ね上がりました。

この調子なら、Agent ワークフローにローカル LLM が当たり前に組み込まれる日もそう遠くないでしょう。claude-token-saver-mcp は Cloud と Local を使い分けるための土台を提供します。

しくみ

MCP (Model Context Protocol) は Claude Code が外部ツールを呼び出すための標準プロトコルです。このサーバーを登録すると、Claude Code がタスクの内容を見て、定型的な処理を自動的にローカル LLM へ回します。

Claude Code ──MCP──▶ token-saver ──HTTP──▶ Ollama (ローカル)
     │                                         │
     │  「定型タスクだ → ローカルに振ろう」        │
     │                                         │
     └─── 高度な推論・設計判断は Cloud で継続 ───┘

Ollama が落ちていたり応答が遅い場合は Cloud API にフォールバック可能です。

30 秒セットアップ

前提: Node.js 20+ と Ollama がインストール済みであること。

0. Ollama を起動

ollama serve

1. プロジェクトルートに .mcp.json を作成

{
  "mcpServers": {
    "token-saver": { "command": "npx", "args": ["-y", "claude-token-saver-mcp"] }
  }
}

2. Claude Code を起動して、こう頼む

コーディング用にローカルLLMをセットアップして

RAM に応じた最適モデルが推奨 → ダウンロード（約 4GB）→ プリロードまで自動で走ります。

3. 動作確認

TypeScript で配列をシャッフルする関数を書いて

「ローカルLLM（qwen2.5-coder:…）で生成しました」のようにローカルモデル名が表示されれば OK。出ない場合は ollama list でモデルを確認し、トラブルシューティングを参照してください。

ソースからビルドする場合

git clone https://github.com/BlackFoil/claude-token-saver-mcp.git
cd claude-token-saver-mcp
npm ci && npm run build

プロジェクトルートの .mcp.json に追加：

{
  "mcpServers": {
    "token-saver": {
      "command": "node",
      "args": ["/path/to/claude-token-saver-mcp/dist/server.js"]
    }
  }
}

特徴

ローカル完結 — 定型タスクは Cloud API を使わずに処理できる
自動モデル選択 — RAM を検出して最適なモデルを推奨・DL・プリロード（auto_setup）
セキュリティ内蔵 — プロンプトインジェクション検知 + 出力サニタイズ
コスト可視化 — 節約額をリアルタイムで追跡（定型タスク比率 40% なら月 $50〜80 程度の削減が目安）
Cloud フォールバック — Ollama が落ちても Cloud に自動切り替え可能

使用例

あなた: 「ソート関数を書いて」    → offload_work がローカルで生成     💰 $0.02 節約
あなた: 「このログを要約して」    → compress_context がローカルで圧縮  💰 $0.05 節約
あなた: 「コスト節約を見せて」    → cost_dashboard: 累計 $47.89 節約
あなた: 「3つのAPIを一括実装して」 → batch_offload: 3 タスクを順次処理

ローカル品質の実際

ローカル 7B モデルの出力は Claude に及びません。それは前提です。ただ、定型タスクに限れば十分実用的です。

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Claude Token Saver: common questions

Is Claude Token Saver MCP server safe?: Mostly: it is graded B (75/100). Read the Claude Token Saver safety report
How do I install Claude Token Saver?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Claude Token Saver need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Claude Token Saver maintained?: The last commit was 218 days ago (2026-03-31). The latest release is v0.3.2.
What can I use instead of Claude Token Saver?: Servers from other publishers that do the same job: Lm MCP server, Serena MCP: the IDE for your agent MCP server and Figma Context MCP server.
How does Claude Token Saver compare with other AI and agents MCP servers?: safety score 75/100 (higher than 45% of 4,460 AI and agents servers); tools 11 (the typical AI and agents server has 6); tools that change things 9% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Claude Token Saver

Same job from other publishers: the closest match first, then the best rated.

Lm
Connect Claude to any OpenAI-compatible LLM endpoint and offload routine work to a local model.
not reviewed
Established
A
Serena MCP: the IDE for your agent
A powerful toolkit for coding, providing semantic retrieval and editing capabilities.
not reviewed
Widely used
C
Figma Context
Give your coding agent access to your Figma data. Implement designs in any framework in one-shot.
not reviewed
Widely used
B
Commonly
Read Commonly pods and post as a Commonly agent you create, with a token from your Commonly account.
not reviewed
Established
A
SuperCompress
Compress coding-agent context ~64%. Hosted Neural Keep MCP for Cursor/Claude/Codex.
not reviewed
Established
B