English Français العربية

io.github.shivam-app-developers/ai-optimizer

السجل الرسمي أدوات المطورين

MCP server that cuts AI coding agent token usage via framework-aware context optimization

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @ai-optimizer/core
Claude Code 
claude mcp add ai-optimizer -e 'AI_OPTIMIZER_LICENSE=<your ai_optimizer_license>' -e 'AI_OPTIMIZER_LSP=<AI_OPTIMIZER_LSP>' -e 'AI_OPTIMIZER_TELEMETRY=<AI_OPTIMIZER_TELEMETRY>' -- npx -y @ai-optimizer/core@0.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "ai-optimizer": {
            "command": "npx",
            "args": [
                "-y",
                "@ai-optimizer/core@0.1.0"
            ],
            "env": {
                "AI_OPTIMIZER_LICENSE": "<your ai_optimizer_license>",
                "AI_OPTIMIZER_LSP": "<AI_OPTIMIZER_LSP>",
                "AI_OPTIMIZER_TELEMETRY": "<AI_OPTIMIZER_TELEMETRY>"
            }
        }
    }
}

متغيرات البيئة

  • AI_OPTIMIZER_LICENSE سري Ed25519 JWT license key. Unlocks Pro/Team packs; free tier needs no key.
  • AI_OPTIMIZER_LSP Set to 0 to disable the LSP bridge (optimized_diagnostics).
  • AI_OPTIMIZER_TELEMETRY Set to 'on' to enable anonymous opt-in telemetry. Off by default.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. AI Token Optimizer
  2. Quickstart
  3. What it does
  4. Tiers
  5. Monorepo layout
  6. Development
  7. Security
  8. License

AI Token Optimizer

An MCP server that cuts AI coding-agent token usage by 60–80% via framework-aware context optimization.

AI coding agents read whole files when they need 15 lines. They load *.g.dart, R.java, node_modules/, and dist/ into context — then do it again next turn. AI Token Optimizer is a Model Context Protocol server that intercepts those tool calls and strips framework noise before it reaches the model.

Works with anything that speaks MCP: Claude Code, Cursor, Cline, Continue, Zed, JetBrains AI, GitHub Copilot agent mode, Antigravity, Windsurf, OpenAI Codex CLI.

Quickstart

npm install -g @ai-optimizer/core

Then point your agent at the ai-optimizer stdio server. For Claude Code, add to ~/.claude/settings.json:

{
  "mcpServers": {
    "ai-optimizer": {
      "command": "ai-optimizer"
    }
  }
}

Or scaffold the config and preview your savings automatically:

npx @ai-optimizer/init
# "we'd skip 47 files, ~14K tokens/session, ~$0.42/session at Sonnet pricing"

Full per-agent setup (Cursor, others), LSP install, and verification steps live in packages/core/README.md.

What it does

It registers tools the agent uses instead of its built-in file/dir/error reads:

ToolWhat it saves
optimized_read_fileFramework-aware skip + optional line slice
optimized_list_filesWalks the tree applying ignore globs (+ .gitignore)
optimized_grepContent search scoped by ignore filters
optimized_diagnosticsSpawns the right LSP, returns errors + a narrow code window
read_symbolLSP workspace/symbol slice instead of a full-file read (Pro/LSP)
strip_bash_noiseStrips ANSI, npm/maven/gradle progress, JVM warnings
optimizer_statusDetected frameworks, active packs, cumulative tokens saved

When a project type is detected (e.g. Python via pyproject.toml), the matching pack's ignore rules activate automatically. .gitignore is respected on top.

Tiers

Free (MIT core)Pro ($9/mo)Team ($29/seat)
Framework packsPython, JS/TS+ React, Flutter, Java, Kotlin, Go, Rust, C#, Swift, Ruby, Elixir, PHP, Solidityall Pro packs
History compaction—✓✓
Scheduler (claude -p cron)—✓+ work-stealing across providers
Audit log + secret redaction + policy——✓

See PRICING.md. Behavior-changing or data-sharing features (scheduler, work-stealing, telemetry) are off by default and require explicit opt-in. Display-only features (dollar-value savings) default on.

Monorepo layout

PackagePurposePublished
packages/coreMCP server + free packsnpm (MIT)
packages/initnpx @ai-optimizer/init config + savings previewnpm
packages/sdkdefinePack plugin SDKnpm
packages/context-mode-importImport .contextmode configsnpm
packages/proPro/Team packs + scheduler + auditprivate
apps/landing, apps/dashboard, apps/vscode-extension, apps/license-serverSite, local dashboard, IDE widget, license issuanceprivate
tools/pack-benchPack quality benchmark harnessprivate

Architecture details: ARCHITECTURE.md.

Development

npm install            # at repo root (workspaces)
npm run build          # build all packages
npm test               # run all test suites

Security

Local-only by design — license validation is the only network call. Report vulnerabilities per SECURITY.md.

License

Core engine is MIT — see LICENSE. Pro/Team packs are proprietary.

الأسئلة الشائعة

ما هو io.github.shivam-app-developers/ai-optimizer؟

MCP server that cuts AI coding agent token usage via framework-aware context optimization

كيف أثبّت io.github.shivam-app-developers/ai-optimizer؟

يعمل على جهازك. في Claude Code: claude mcp add ai-optimizer -e 'AI_OPTIMIZER_LICENSE=<your ai_optimizer_license>' -e 'AI_OPTIMIZER_LSP=<AI_OPTIMIZER_LSP>' -e 'AI_OPTIMIZER_TELEMETRY=<AI_OPTIMIZER_TELEMETRY>' -- npx -y @ai-optimizer/core@0.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.shivam-app-developers/ai-optimizer إلى مفتاح API؟

نعم. يتطلب AI_OPTIMIZER_LICENSE، وتضبطها في إعداداته.

هل io.github.shivam-app-developers/ai-optimizer مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.shivam-app-developers/ai-optimizer؟

ينشره shivam-app-developers. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.