convez.ai
MCP ServerDevOps & InfraestruturaIntermediário
satyamkumar68

Servidor MCP Otimizado para Token

satyamkumar68/optimized-mcp-server

MCP server que otimiza consumo de tokens em 40-80% via YAML e Markdown

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP de alto desempenho construído em Node.js e TypeScript que minimiza o consumo de tokens LLM através de serialização YAML, conversão inteligente HTML-to-Markdown e contagem pré-voo de tokens via tokenizador BPE. Reduz overhead de contexto em até 80% em respostas de ferramentas.

Instalação

$npx convez-ai satyamkumar68/optimized-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Reduzir consumo de tokens em agentes de IA conectados via MCP
  • Extrair conteúdo web limpo e estruturado otimizado para LLMs
  • Consultar métricas e bases de dados retornando YAML compacto
  • Evitar exhaustão de context window em aplicações de IA

Veredito

Solução técnica sólida e pragmática para quem precisa otimizar custos de tokens em produção. Implementação bem arquitetada com ferramentas específicas (web extraction, metrics queries) e documentação clara sobre ganhos reais (~40-80% de redução). Recomendado para builders que trabalham com contextos longos ou orçamentos apertados de API.

README

A tradução para o português deste README ainda está na fila.

Token-Optimized MCP Server

A high-performance Model Context Protocol (MCP) server built with Node.js and TypeScript. This server is purpose-built to minimize LLM token consumption through YAML serialization, structural HTML-to-Markdown distillation, and pre-flight token counting via the BPE tokenizer.


Table of Contents


Overview

Modern AI agents connected via MCP suffer from context window exhaustion when tool responses contain verbose JSON payloads or raw HTML. This server addresses the problem at the architecture layer:

Optimization StrategyToken Reduction
YAML serialization over JSON~40–48%
HTML → structured Markdown~60–80%
Pre-flight token gatingPrevents overflow

All diagnostic logging is routed to stderr to preserve the JSON-RPC protocol integrity on stdout.


Available Tools

extract_web_content

Fetches a web page, strips HTML noise, and returns clean, semantically structured Markdown optimized for LLM consumption.

ParameterTypeRequiredDescription
urlstringYesA valid URL to fetch and convert.

Example input:

{
  "url": "https://example.com"
}

Returns: Token-efficient Markdown with preserved heading hierarchy, links, and tables. Token count is logged to stderr.


query_metrics_database

Queries an internal metrics database and returns the results serialized in YAML format to reduce token overhead by approximately 45% compared to equivalent JSON.

ParameterTypeRequiredDescription
querystringYesA natural-language or structured query string.

Example input:

{
  "query": "Show CPU and memory usage for the last hour"
}

Returns: YAML-formatted metrics payload. If the response exceeds 8,000 tokens, a warning is emitted to stderr recommending semantic chunking.

Note: The metrics database initializes automatically as an in-memory instance on server startup. No external setup, schema migration, or configuration is required.


Prerequisites

  • Node.js v18.0.0 or higher
  • npm v9+ (bundled with Node.js 18+)

Verify your installation:

node --version   # Must be >= 18.0.0
npm --version

Installation

# Clone or navigate to the project directory
cd optimized-mcp-server

# Install all dependencies
npm install

Dependencies at a Glance

PackagePurpose
@modelcontextprotocol/sdkOfficial MCP server SDK
zodRuntime input schema validation
js-tiktokenBPE token counting (OpenAI compatible)
node-html-markdownHigh-fidelity HTML → Markdown conversion
@kreuzberg/html-to-markdownNative Rust-binding Markdown converter
yamlJSON → YAML serialization

Building

Compile the TypeScript source to JavaScript:

npm run build

The compiled output is written to the build/ directory.


Configuration

To connect this server to an MCP-compatible AI host, register it in the host's configuration file. Below are copy-pasteable templates for common hosts.

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "token-optimized-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/optimized-mcp-server/build/index.js"
      ]
    }
  }
}

Important: Replace /absolute/path/to/ with the actual absolute path on your system. On Windows, use double backslashes (\\) or forward slashes (/) in JSON strings.

After saving, fully quit and restart Claude Desktop to re-initialize the JSON-RPC handshake.


VS Code / Antigravity IDE

Add the following to your MCP configuration file (typically mcp_config.json in your editor's settings directory):

{
  "mcpServers": {
    "token-optimized-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/optimized-mcp-server/build/index.js"
      ]
    }
  }
}

Windows example:

"args": [
    "C:\\Users\\YourName\\projects\\optimized-mcp-server\\build\\index.js"
]

Usage

Development Mode

Run the server directly from TypeScript source using tsx (no build step required):

npm run dev

Production Mode

Build first, then start the compiled server:

npm run build
npm start

MCP Inspector

The MCP Inspector provides a browser-based UI for testing tools, simulating LLM requests, and inspecting JSON-RPC messages — no API keys required.

npx @modelcontextprotocol/inspector node build/index.js

This launches a local proxy and opens the Inspector UI in your default browser. Use it to:

  1. Verify the protocol handshake completes successfully.
  2. Execute extract_web_content with a test URL.
  3. Execute query_metrics_database and confirm YAML output.
  4. Monitor stderr logs for token counts and threshold warnings.

Project Structure

optimized-mcp-server/
├── src/
│   └── index.ts          # Core server implementation
├── build/                # Compiled JavaScript output (generated)
├── node_modules/         # Dependencies (generated)
├── package.json          # Project metadata and scripts
├── tsconfig.json         # TypeScript compiler configuration
├── .gitignore            # Git exclusion rules
├── README.md             # This file

License

ISC

Ver o original no GitHub

Bom para

Relacionados