1. Conduid
  2. Blockchain
  3. io.github.yifanyifan897645/mcp-checkup
MCP server · Blockchain

io.github.yifanyifan897645/mcp-checkup

by · github.com/yifanyifan897645/mcp-checkup

Analyze your MCP setup: token costs, grades, duplicates, and optimization tips

Unclaimed last commit 6 months ago blockchain
InstallView source
37Low

Scored 6 months ago · breakdown

About io.github.yifanyifan897645/mcp-checkup

io.github.yifanyifan897645/mcp-checkup is an MCP server published by yifanyifan897645 in the Blockchain category: analyze your MCP setup: token costs, grades, duplicates, and optimization tips.

The repository has 1 stars and 1 forks, with the last commit 6 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

Claude Code
claude mcp add io-github-yifanyifan897645-mcp-checkup -- npx -y mcp-checkup
npx
npx -y mcp-checkup

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (3)

**mcp-checkup**Diagnose token costs

Parameters not published.

[MCP Inspector](https://github.com/modelcontextprotocol/inspector)Debug MCP servers

Parameters not published.

[lean-ctx](https://github.com/yvgude/lean-ctx)Reduce token usage

Parameters not published.

Ask AI

✦

Ask AI about io.github.yifanyifan897645/mcp-checkup

Powered by Claude · Grounded in docs

I know everything about io.github.yifanyifan897645/mcp-checkup. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

mcp-checkup

npm version npm downloads

Your MCP servers are eating your context window. Find out how much.

mcp-checkup is an MCP server that analyzes your MCP setup — measuring the token cost of every installed server and tool, finding duplicates, grading efficiency, and generating optimization reports.

Quick Start

npx mcp-checkup

Then ask your AI assistant:

"Run an MCP health check on my setup"
"How many tokens are my MCP servers using?"
"Generate an MCP health report"

Why?

Every MCP tool costs 550–1,400 tokens just for its schema. A server with 50 tools can eat 30,000+ tokens before you type anything. Most developers have no idea how much context window their MCP servers are consuming.

Real examples from the community:

  • Adding GitHub MCP increased one user's token usage from 34K to 80K (source)
  • One developer found 67,000 tokens consumed by just 4 servers before any conversation (source)
  • Context7 (240K weekly downloads) has tool descriptions costing 3x more tokens than necessary (source)

Tools

analyze_servers

Scan your MCP config and measure the token cost of every installed server. Auto-detects config files.

"Which of my MCP servers costs the most tokens?"

analyze_tools

Deep-dive into a specific server — per-tool token costs, grades, bloated descriptions, and optimization suggestions.

"Break down the token cost of my GitHub MCP server"

find_duplicates

Find duplicate tool names across your installed servers. Redundant tools waste context for no benefit.

"Do any of my MCP servers have overlapping tools?"

count_tokens

Count tokens in any text. Useful for estimating context usage.

"How many tokens is this prompt?"

generate_report

Full markdown health report: server grades (A-F), token costs, duplicates, and actionable recommendations.

"Generate a full MCP health report"

Grading System

Per-Tool Grades

Grade Tokens Meaning
A ≤100 Excellent — minimal context cost
B ≤300 Good — reasonable schema size
C ≤600 Fair — could be optimized
D ≤1000 Poor — bloated schema
F >1000 Failing — severely impacts context window

Per-Server Grades

Grade Total Tokens Meaning
A ≤500 Lean and efficient
B ≤1500 Reasonable
C ≤3000 Getting heavy
D ≤6000 Significant context cost
F >6000 Major context window drain

Installation

Claude Desktop / Claude Code

{
  "mcpServers": {
    "mcp-checkup": {
      "command": "npx",
      "args": ["-y", "mcp-checkup"]
    }
  }
}

Cursor

Add to .cursor/mcp.json with the same format.

Auto-Detection

mcp-checkup automatically finds your MCP config in these locations:

  • .mcp.json (current directory)
  • Claude Desktop config (Windows/macOS/Linux)
  • .cursor/mcp.json

Or pass a custom path to any tool.

How It Compares

Tool Purpose Approach
mcp-checkup Diagnose token costs Analyze & report — see exactly what each tool costs
lean-ctx Reduce token usage Compress context at runtime
MCP Inspector Debug MCP servers Test connections and tool calls

Use mcp-checkup first to find the problem, then decide how to fix it.

Part of the MCP Toolkit

View all servers →

License

MIT

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About io.github.yifanyifan897645/mcp-checkup

How do I install io.github.yifanyifan897645/mcp-checkup?

Run claude mcp add io-github-yifanyifan897645-mcp-checkup -- npx -y mcp-checkup, then add the server to your MCP client's configuration.

Is io.github.yifanyifan897645/mcp-checkup safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.yifanyifan897645/mcp-checkup still maintained?

The last commit was 6 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.