mcpeye 0.1.0

data/lib/mcpeye/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Mcpeye
+  VERSION = "0.1.0"
+end

data/lib/mcpeye.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require_relative "mcpeye/version"
+require_relative "mcpeye/intent"
+require_relative "mcpeye/request_capability"
+require_relative "mcpeye/redaction"
+require_relative "mcpeye/tracker"
+
+# mcpeye — intent-gap analytics for MCP servers. "See why your agent is failing."
+#
+# This gem instruments a Ruby/Rails MCP server: it injects the optional
+# `mcpeyeIntent` parameter into your tool schemas, captures every tool call
+# (redacting secrets/PII client-side), buffers them, and POSTs the same
+# IngestPayload JSON contract that every mcpeye SDK speaks to your self-hosted
+# mcpeye instance at "#{ingest_url}/ingest".
+module Mcpeye
+  # Instrument an MCP server and return a Tracker.
+  #
+  #   tracker = Mcpeye.track(
+  #     server,
+  #     "my-project-id",
+  #     ingest_url: "http://localhost:3001",          # or ENV["MCPEYE_INGEST_URL"]
+  #     ingest_secret: ENV["MCPEYE_INGEST_SECRET"],
+  #     redact: true,
+  #     flush_interval: 5,                            # background flush every 5s (opt-in)
+  #     identify: -> { { userId: Current.user_id } }, # per-flush identity (opt-in)
+  #     on_error: ->(e) { Rails.logger.warn(e) }      # diagnostics sink (opt-in)
+  #   )
+  #
+  # The intent param is injected into discoverable tool schemas and discoverable
+  # handlers are wrapped. For servers whose internals can't be introspected, use
+  # the returned Tracker's #wrap / #record / #flush directly.
+  #
+  # When `flush_interval` is set, a background flush thread is started for you.
+  # A drain is registered via at_exit, so callers no longer must remember it
+  # (the explicit `at_exit { tracker.flush }` still works — it's idempotent).
+  # In a forking server (Puma/Unicorn cluster) the thread does not survive fork:
+  # call `tracker.start_flush_thread` from `on_worker_boot`. See the README.
+  #
+  # Returns the Tracker.
+  def self.track(server, project_id,
+                 ingest_url: nil,
+                 ingest_secret: nil,
+                 redact: true,
+                 identity: {},
+                 identify: nil,
+                 flush_interval: nil,
+                 on_error: nil,
+                 **opts)
+    tracker = Tracker.new(
+      project_id,
+      ingest_url: ingest_url,
+      ingest_secret: ingest_secret,
+      redact: redact,
+      identity: identity,
+      identify: identify,
+      flush_interval: flush_interval,
+      on_error: on_error,
+      **opts
+    )
+    tracker.instrument(server)
+    tracker.start_flush_thread
+    at_exit { tracker.at_exit_drain }
+    tracker
+  end
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification
+name: mcpeye
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- mcpeye
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-06-21 00:00:00.000000000 Z
+dependencies: []
+description: mcpeye captures what your agents try to do through your MCP tools — including
+  the asks your tools could NOT fulfill — and ships them to a self-hosted mcpeye instance
+  for the Intent Gap Report. This gem instruments a Ruby/Rails MCP server.
+email:
+- saas@healinbox.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/mcpeye.rb
+- lib/mcpeye/intent.rb
+- lib/mcpeye/redaction.rb
+- lib/mcpeye/request_capability.rb
+- lib/mcpeye/tracker.rb
+- lib/mcpeye/version.rb
+homepage: https://github.com/mcpeye/mcpeye
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/mcpeye/mcpeye
+  source_code_uri: https://github.com/mcpeye/mcpeye
+  changelog_uri: https://github.com/mcpeye/mcpeye/releases
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: Product analytics for Ruby/Rails MCP servers.
+test_files: []