terminal-love-mcp
This server lets you search, browse, and visually inspect CLI/TUI tools from Terminal Trove, serving as a design reference resource for terminal user interfaces.
Search & Discovery
search_tools— Search the live Terminal Trove catalog via the site's Typesense APIsearch_catalog— Offline fuzzy search across the full local catalog indexbrowse_category— List all tools within a specific category (e.g.git,networking)list_categories— Retrieve all 70+ available categoriesnewly_added— Get the most recently added tools on Terminal Trovetool_of_the_week— Fetch the current and archived "Tool of the Week" picks
Tool Details
get_tool— Retrieve full details: description, GitHub URL, language, license, platforms, tags, install commands, and screenshot URLsrelated_tools— Find tools related to a given tool by shared primary category
Screenshots & Visual Inspection
list_screenshots— List all screenshot/GIF metadata (URL, type, alt text, dimensions) for a toolview_screenshot— Fetch a TUI screenshot or demo GIF and return it as an inline base64 image block
GitHub Stats
get_repo_stats— Fetch repository statistics: stars, forks, open issues, language, license, last push, and topics
Catalog Management
sync_catalog— Build or refresh a full local catalog index from the Terminal Trove sitemap for offline use
MCP Resources
terminaltrove://tool/{slug}— Read a tool's structured JSON directly as an MCP resource without a tool call
Provides tools for querying GitHub repository statistics (stars, forks, issues, language, license, topics, last push) to gauge maturity and popularity of tools.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@terminal-love-mcp search for TUI file managers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
terminal-love-mcp
MCP server over Terminal Trove — search the catalog and pull TUI/CLI design references (screenshots, demo GIFs, install commands, metadata) so an agent can study real terminal UIs while building one.
Built for wiring into the Vanta agent, but works with any MCP client.
Why
Terminal Trove curates hundreds of CLI/TUI tools, each page carrying the gold you want when designing a terminal UI: real screenshots + demo GIFs, the GitHub repo, language, license, platform support, and copy-pasteable install commands. There's no public API, so this server scrapes the (clean, stable) HTML and the site's Typesense search endpoint, caches politely to disk, and exposes everything as MCP tools — including returning screenshots as viewable image blocks so the agent can actually see the layout.
Related MCP server: can-see
Install
npm install
npm run buildWire into Vanta (or any MCP client)
Add to your client's MCP config (e.g. .mcp.json / claude_desktop_config.json):
{
"mcpServers": {
"terminal-love": {
"command": "node",
"args": ["/Users/jasonpoindexter/Documents/GitHub/_tools/terminal love mcp/dist/index.js"]
}
}
}Optional env (all have sane defaults — see .env.example):
TTROVE_CACHE_DIR— where HTML/catalog cache lives (default: OS tmp)TTROVE_CACHE_TTL_MS— tool-page/catalog cache lifetime (default 6h)TTROVE_SEARCH_TTL_MS— search-response cache lifetime (default 1h; fresher than pages)TTROVE_LOG_LEVEL— pino level (defaultinfo; logs go to stderr, never stdout)GITHUB_TOKEN— raises the rate limit forget_repo_stats/get_tool with_stars
Tools
Collection-returning tools share one shape:
{ count, items, ...context }(e.g.search_tools→{ query, count, items },browse_category→{ category, count, items }). Single-entity tools (get_tool,get_repo_stats) return the object directly.
Tool | Input | Returns |
|
| Full details: description, GitHub, language, license, platforms, tags, install commands, screenshot URLs (+ GitHub |
|
| Live search results (Terminal Trove Typesense) as tool summaries |
|
| Tools sharing the input's primary category |
|
| GitHub stars/forks/issues/language/license/topics/pushedAt |
| — | All 70+ categories (slug, name, url) |
|
| Tools in a category (name + description) |
|
| Recently added tools ( |
| — | Current pick + archive |
|
| Screenshot/GIF URLs + dimensions for a tool |
|
| The image itself as a base64 MCP image block (CDN-host allowlisted, 8 MB cap) |
|
| Build/refresh the full local catalog index from the sitemap |
|
| Offline fuzzy search across the whole catalog (after first sync) |
Resources
Tool pages are also exposed as MCP resources, so a client can read a tool's structured JSON by URI without spending a tool call:
Resource | URI | Returns |
Terminal Trove tool |
| The same JSON as |
Typical flow for Vanta
search_tools/search_catalog/browse_category→ find candidate TUIsget_tool→ read structure, install, screenshot URLsview_screenshot→ actually see the layout to learn fromget_repo_stats→ gauge maturity/popularity
Development
npm run dev # run the server via tsx (stdio)
npm test # vitest (parsers tested against saved HTML fixtures)
npm run typecheck
npm run smoke # build + end-to-end stdio smoke test against the live site
npm run demo # build + simulate the full Vanta research flow
npm run verify # build + assert every tool against the LIVE site (drift guard, exits non-zero on failure)
npm run inspect # open the MCP InspectorDesign notes
stdio transport — stdout is the JSON-RPC stream; all logging is forced to stderr.
Polite scraping — 6h disk cache, custom user-agent, retry-with-backoff, 15s timeout.
Pure parsers — all HTML parsing lives in pure functions tested against fixtures in
src/features/*/__fixtures__/, so a Terminal Trove markup change is caught by a failing test.See
DECISIONS.mdfor locked architectural choices andPARKED.mdfor deferred ideas.
Available Tools
12 toolsbrowse_categoryBrowse categoryA
Browse tools in a Terminal Trove category. Returns slug, name, URL, and description for each tool. Use list_categories first to discover valid category slugs.
Inputs: category (required), limit.
get_repo_statsGet GitHub repo statsA
Fetch GitHub repository statistics for a Terminal Trove tool: stars, forks, open issues, language, license, last push, and topics. Provide github_url, slug, or both.
Inputs: github_url, slug.
get_toolGet tool detailsA
Full Terminal Trove details for a tool: description, GitHub, language, license, platforms, tags, install commands, and screenshot URLs.
Inputs: slug (required).
list_categoriesList categoriesA
List all tool categories available on Terminal Trove. Returns slug, name, and URL for each category.
Inputs: no named parameters.
list_screenshotsList screenshotsA
List all screenshot / demo-GIF metadata (url, type, alt, dimensions) for a Terminal Trove tool. Use this before view_screenshot to pick an index.
Inputs: slug (required).
newly_addedNewly added toolsA
Returns the most recently added terminal tools from terminaltrove.com/new/, newest first. Each entry includes slug, name, URL, and description.
Inputs: limit.
search_catalogSearch terminal tool catalogA
Fuzzy-searches the local Terminal Trove catalog index by tool name or slug. The search is fully offline after the first sync_catalog call — no network required. Returns matching tools with their score (0 = perfect).
Inputs: query (required), limit.
search_toolsSearch toolsB
Search the Terminal Trove catalog. Returns tool summaries (slug, name, tagline, thumbnail URL). Uses the site's Typesense search API.
Inputs: query (required), limit.
sync_catalogSync terminal tool catalogA
Fetches the full Terminal Trove catalog from sitemap + /list/ and builds a local index for fast offline search. Returns the tool count, build timestamp, and a 10-item sample. Pass force=true to force a rebuild even if the index is fresh.
Inputs: force.
tool_of_the_weekTool of the WeekA
Returns the current Terminal Tool of the Week plus an archive of past picks from terminaltrove.com/tool-of-the-week/. Each archive entry includes the date label (e.g. 'June 2, 2026').
Inputs: no named parameters.
view_screenshotView screenshotA
Fetch a TUI screenshot or demo GIF from Terminal Trove and return it as an inline image so you can visually inspect the design. Provide slug (+ optional index) OR a cdn.terminaltrove.com url directly.
Inputs: slug, url, index.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Each tool has a clearly distinct purpose: browsing, searching, viewing details, screenshots, stats, etc. The two search tools are differentiated by offline/online mode. No ambiguity.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., browse_category, get_repo_stats, list_categories). No mixing of conventions.
12 tools is well-scoped for a catalog browsing service, covering all necessary operations without being overwhelming or too sparse.
The tool set fully covers browsing, searching, and inspecting Terminal Trove tools with no missing operations. It is a read-only service, so it's complete for its domain.
Maintenance
Related MCP Connectors
Search, vet & assemble MCP servers from your agent: verified tools, risk labels, and trust scores.
Capability registry for the agentic economy. Semantic search over verified MCP server listings.
Find, compare, and audit software for AI agents. Scored registry of tools and MCP servers.
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that publishes CLI tools on your machine for discoverability by LLMs4 npm1MIT
- AlicenseNot gradedqualityCmaintenanceMCP server that lets AI agents see and interact with terminal/CLI applications through virtual terminals and PNG screenshots.77 npmMIT
- FlicenseAqualityDmaintenanceMCP server that gives AI agents browser-based access to Mobbin for design research, screen discovery, and screenshot collection through automated browser control.103-
- AlicenseNot gradedqualityCmaintenanceMCP tool server that gives any AI agent the ability to search, scrape, and analyze content across the internet.42MIT