Skip to content

docs: use npx eth-labels-mcp β€” zero clone, zero build setup#112

Open
dawsbot wants to merge 3 commits intov1from
improve-mcp-setup
Open

docs: use npx eth-labels-mcp β€” zero clone, zero build setup#112
dawsbot wants to merge 3 commits intov1from
improve-mcp-setup

Conversation

@dawsbot
Copy link
Copy Markdown
Owner

@dawsbot dawsbot commented Jan 30, 2026

What

Now that eth-labels-mcp is live on npm, the README setup instructions should use it directly. No more clone + build.

Changes

Every client config now uses npx eth-labels-mcp instead of node /absolute/path/to/...:

  • Claude Code: claude mcp add eth-labels-mcp -- npx eth-labels-mcp (one-liner)
  • Claude Desktop / Cursor / Windsurf / VS Code / Cline: "command": "npx", "args": ["-y", "eth-labels-mcp"]
  • Removed clone/build instructions from the main setup flow
  • Fixed verify section (was using an address not in the dataset)
  • Claude Code section is <details open> since it's the most common path

Tested

Verified on macOS:

  • npm install -g eth-labels-mcp βœ… (all 3 tools work)
  • npx eth-labels-mcp βœ… (zero-install, auto-downloads 5.2MB package)
  • search_labels returns results (uniswap, binance)
  • dataset_stats confirms 169,667 entries loaded
  • lookup_address works for known addresses

- Add setup instructions for Claude Code, Claude Desktop, Cursor, Windsurf, VS Code (Copilot), and Cline
- Use collapsible sections to keep README clean
- Add Claude Code CLI one-liner (claude mcp add)
- Update dataset stats: 115k+ accounts, 54k+ tokens, 170k+ total
- Add absolute path tip for MCP client compatibility
- Fix config file paths for each platform (macOS/Windows/Linux)
- Lead with npm install -g (Option A) vs clone from source (Option B)
- Add Node.js 18+ prerequisite
- Add 'Verify it works' section with Vitalik address test
- Restructure client configs under 'Add to your AI client' header
- Claude Desktop paths in a table instead of bullet list
- Claude Code section emphasizes it's a one-liner
- Prep npx comment for when package is published
- Every client config now uses npx eth-labels-mcp (zero build)
- Claude Code is a true one-liner: claude mcp add eth-labels-mcp -- npx eth-labels-mcp
- Added -y flag for Cursor/Windsurf/VS Code/Cline (auto-confirm npx install)
- Removed clone/build instructions from main setup flow
- Fixed verify section (Vitalik address not in dataset, use search instead)
- Claude Code section is open by default (most common)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants