A Ruby gem that provides MCP tools for querying RubyGems package intelligence with local-first, cached, and provenance-tagged answers.

Stars

6

7-day growth

No data

Forks

0

Open issues

0

License

MIT

Last updated

2026-07-30

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

Offers a unique offline-first approach for gem queries, leveraging local gemspecs and caching to reduce API calls and provide trustworthy metadata directly to AI agents.

Who it is for

  • Ruby developers managing gem dependencies
  • AI agent developers integrating package intelligence
  • DevOps engineers auditing gem ecosystems
  • Ruby tool authors needing structured gem metadata

Use cases

  • Check gem ownership and maintenance status
  • Verify version compatibility between gems
  • Explore dependency graphs for a gem
  • List all releases between two gem versions

Strengths

  • Local-first resolution reduces network dependency and speeds up responses
  • Persistent caching with ETag and stale-while-revalidate ensures reliability
  • Rate limiting and atomic cache writes prevent API abuse and data corruption
  • Provides structured, provenance-tagged results that AI agents can trust

Considerations

  • Dependency graph is exploratory and does not consider lockfiles, Ruby versions, or platforms
  • Compatibility checker is not a full constraint solver and only checks declared dependencies
  • Requires Ruby environment and gem installation; not a standalone tool

README quick start

gemcp

MCP tools for RubyGems package intelligence. Ask about gems, versions, dependencies, and ownership. Get structured, provenance-tagged answers an agent can trust.

Install

gem install gemcp

MCP client config

Add to your MCP client (Claude Desktop, Kiro, etc.):

{
  "mcpServers": {
    "gemcp": {
      "command": "gemcp"
    }
  }
}

That's it. If your Ruby isn't on the default PATH, use the full path:

{
  "mcpServers": {
    "gemcp": {
      "command": "/path/to/gemcp"
    }
  }
}

Find it with gem which gemcp && which gemcp.

What it does

gemcp reads from installed gemspecs first, a persistent disk cache second, and the RubyGems.org API only when neither has what you need.

Tools

ToolPurpose
search_gemsSearch installed gems first, then RubyGems.org
get_gemCurrent gem metadata, preferring an installed gemspec
list_gem_versionsInstalled versions first, registry versions otherwise
get_gem_versionExact local version/platform first, API v2 otherwise
get_gem_ownersPublic owner/maintainer data from RubyGems.org
get_dependency_graphBounded exploratory graph with constraints on edges
get_gem_contextAggregated context: metadata + recent versions + owners
check_compatibilityDetect dependency conflicts between two gem versions
get_releases_betweenList all releases between two versions of a gem
reverse_dependenciesFind gems that depend on a given gem
compare_versionsDiff dependency requirements between two versions

Example questions

These are the kinds of questions gemcp helps an agent answer with authoritative data:

  • "Is sidekiq still actively maintained? Who owns it on RubyGems?"
  • "What Ruby version does nokogiri 1.18.8 require?"
  • "Can authlogic 3.6 coexist with Rails 8?"
  • "What changed in authlogic's dependencies between version 3.6.1 and 6.6.0?"
  • "What gems depend on rack?"
  • "Show me every release of rails between 7.0.0 and 8.0.0"
  • "Compare puma and unicorn — versions, owners, dependency counts"
  • "What are the runtime dependencies of rails 8.1?"
  • "Build me a dependency graph for sidekiq at depth 2"
  • "Find me gems for background job processing"

How it resolves data

installed gemspecs
      ↓ miss
fresh disk cache
      ↓ stale/miss
conditional RubyGems.org req

Description

Read-only MCP tools for RubyGems package metadata, versions, owners, search, and dependency graphs, with local gem lookup, caching, and rate limiting.

Related repositories

Similar projects matched by category, topics, and programming language.

mereyabdenbekuly-ctrl
Featured
mereyabdenbekuly-ctrl GitHub avatar

clodex-ide

Clodex is an open-source, local-first agentic IDE that combines persistent AI tasks, code, terminal, browser, Git, models, memory, and governed execution in one Electron workspace, currently in technical preview.

AI & Machine LearningAI Agents
859
0xwilliamortiz
Featured
0xwilliamortiz GitHub avatar

openclaude-improved

OpenClaude is an open-source CLI coding agent that runs on any platform and supports a wide range of LLM providers, offering the same tools and workflows as Claude Code.

AI & Machine LearningLarge Language Models
577
MoonshotAI
Featured
MoonshotAI GitHub avatar

Kimi-K3

Kimi K3 is an open-weight, 2.8T-parameter native multimodal agentic model with a 1M-token context window, designed for frontier coding, knowledge work, and reasoning tasks.

AI & Machine LearningAI Agents
3,348