mathpix 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11a43b1643362801778dbc02b4ec45c3e4cc5bda4dc3b20c191a699c22a67c9d
-  data.tar.gz: 80b902ab983d1a3c1d3a8483646c861edfb77d5ad8b573a66b60d7a0b82cea33
+  metadata.gz: 505743d5f7053fd9d144cfeae3b393939cf017bc2b688bcf387bb38f99638f63
+  data.tar.gz: b4da654108c53835f9c930a88c17d3e7ff05f9549bb6af187f27f1ef643cb63b
 SHA512:
-  metadata.gz: 5b7aa48fd8fd1c983412221f9cf4c06df4a4bb52bd2c217da9125c39f8ebec27755b830457ce6469ee80bba102935987bd686d53a9bfab92ccae30e9264b67d9
-  data.tar.gz: 74aa5937731cb5661d7fecd8354617e6548ddb7d09dd951b2d5559ac9eb9005f620cd12f76c7fe883c77d7f06351f4146c9b5a3128474d715e67c4e3c4a12346
+  metadata.gz: e7dffca4483cc4fc058f45ea1d16426a82acf2323e77507739452b4435e566c61501370a60a64a1e414ff950bcfec50bbb78a886c53e7336ff77cd86e5595ff5
+  data.tar.gz: 3c620adca1e9a1a51d9651706119c5869575cbe961979a6618b1e69d3e5db0b27129d3f31d0c75abadd95243cef9927e2745f7182618788e2c01c99d99b088fd

data/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.1] - 2025-10-13
+
+### Added
+- MCP server executable (`bin/mathpix-mcp`) for Claude Code integration
+- Comprehensive MCP setup documentation (`MCP_SETUP.md`)
+- Recovery codes backup documentation with MATHPIX prefix naming convention
+- GitHub issues created from code TODOs for future enhancements
+
+### Changed
+- Recovery code backup files now use MATHPIX prefix for clarity
+- Updated `.gitignore` to allow MCP_SETUP.md in repository
+
+### Documentation
+- Added detailed MCP server installation guide
+- Documented 9 available MCP tools
+- Documented 4 available MCP resources
+- Added troubleshooting section for common MCP issues
+- Documented secure backup locations for recovery codes
+
 ## [0.1.0] - 2025-10-13
 
 ### Added

data/README.md

@@ -163,7 +163,7 @@ MIT License - see [LICENSE](LICENSE) for details.
 
 ## Support
 
-- GitHub Issues: https://github.com/teglonlabs/mathpix-mcp-server/issues
+- GitHub Issues: https://github.com/TeglonLabs/mathpix-gem/issues
 - Email: ies@prototypesf.org
 
 ---

data/SECURITY.md

@@ -130,7 +130,7 @@ spec.metadata['rubygems_mfa_required'] = 'true'
 
 For security-related questions or concerns:
 - Email: ies@prototypesf.org
-- GitHub Issues: https://github.com/teglonlabs/mathpix-mcp-server/issues (for non-sensitive issues)
+- GitHub Issues: https://github.com/TeglonLabs/mathpix-gem/issues (for non-sensitive issues)
 
 ## Acknowledgments
 

data/bin/mathpix-mcp

@@ -0,0 +1,55 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'mathpix'
+require 'mathpix/mcp/server'
+
+# Load environment variables from .env file if present
+require 'dotenv/load' if defined?(Dotenv)
+
+# Configure Mathpix from environment
+Mathpix.configure do |config|
+  config.app_id = ENV['MATHPIX_APP_ID']
+  config.app_key = ENV['MATHPIX_APP_KEY']
+
+  # Optional configuration
+  config.max_file_size_mb = ENV['MATHPIX_MAX_FILE_SIZE_MB']&.to_i || 10
+  config.https_only = ENV['MATHPIX_HTTPS_ONLY'] != 'false'
+
+  # Logging
+  if ENV['MATHPIX_LOG_LEVEL']
+    require 'logger'
+    config.logger = Logger.new($stderr)
+    config.logger.level = Logger.const_get(ENV['MATHPIX_LOG_LEVEL'].upcase)
+  end
+end
+
+# Start MCP server
+begin
+  server = Mathpix::MCP::Server.new
+
+  # Register all tools
+  server.register_tool(Mathpix::MCP::Tools::ConvertImageTool.new)
+  server.register_tool(Mathpix::MCP::Tools::ConvertDocumentTool.new)
+  server.register_tool(Mathpix::MCP::Tools::CheckDocumentStatusTool.new)
+  server.register_tool(Mathpix::MCP::Tools::BatchConvertTool.new)
+  server.register_tool(Mathpix::MCP::Tools::GetAccountInfoTool.new)
+  server.register_tool(Mathpix::MCP::Tools::GetUsageTool.new)
+  server.register_tool(Mathpix::MCP::Tools::ListFormatsTool.new)
+  server.register_tool(Mathpix::MCP::Tools::ConvertStrokesTool.new)
+  server.register_tool(Mathpix::MCP::Tools::SearchResultsTool.new)
+
+  # Register resources
+  server.register_resource(Mathpix::MCP::Resources::FormatsListResource.new)
+  server.register_resource(Mathpix::MCP::Resources::LatestSnipResource.new)
+  server.register_resource(Mathpix::MCP::Resources::RecentSnipsResource.new)
+  server.register_resource(Mathpix::MCP::Resources::SnipStatsResource.new)
+
+  # Start server on stdio
+  server.start
+rescue StandardError => e
+  warn "Error starting Mathpix MCP server: #{e.message}"
+  warn e.backtrace.join("\n")
+  exit 1
+end

data/lib/mathpix/version.rb

@@ -2,7 +2,7 @@
 
 module Mathpix
   # Gem version following semantic versioning
-  VERSION = '0.1.0'
+  VERSION = '0.1.1'
 
   # Seed for deterministic behavior
   SEED = 1069

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mathpix
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Barton Rhodes
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2025-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mcp
@@ -198,7 +199,8 @@ description: |
   The geodesic path to mathematical OCR in Ruby.
 email:
 - ies@prototypesf.org
-executables: []
+executables:
+- mathpix-mcp
 extensions: []
 extra_rdoc_files: []
 files:
@@ -206,6 +208,7 @@ files:
 - LICENSE
 - README.md
 - SECURITY.md
+- bin/mathpix-mcp
 - lib/mathpix.rb
 - lib/mathpix/balanced_ternary.rb
 - lib/mathpix/batch.rb
@@ -251,18 +254,19 @@ files:
 - lib/mathpix/mcp/transports/sse_stream_handler.rb
 - lib/mathpix/result.rb
 - lib/mathpix/version.rb
-homepage: https://github.com/teglonlabs/mathpix-mcp-server
+homepage: https://github.com/TeglonLabs/mathpix-gem
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/teglonlabs/mathpix-mcp-server
-  source_code_uri: https://github.com/teglonlabs/mathpix-mcp-server
-  changelog_uri: https://github.com/teglonlabs/mathpix-mcp-server/blob/main/CHANGELOG.md
+  homepage_uri: https://github.com/TeglonLabs/mathpix-gem
+  source_code_uri: https://github.com/TeglonLabs/mathpix-gem
+  changelog_uri: https://github.com/TeglonLabs/mathpix-gem/blob/master/CHANGELOG.md
   documentation_uri: https://docs.mathpix.com
-  bug_tracker_uri: https://github.com/teglonlabs/mathpix-mcp-server/issues
-  wiki_uri: https://github.com/teglonlabs/mathpix-mcp-server/wiki
+  bug_tracker_uri: https://github.com/TeglonLabs/mathpix-gem/issues
+  wiki_uri: https://github.com/TeglonLabs/mathpix-gem/wiki
   rubygems_mfa_required: 'true'
-  security_policy_uri: https://github.com/teglonlabs/mathpix-mcp-server/blob/main/SECURITY.md
+  security_policy_uri: https://github.com/TeglonLabs/mathpix-gem/blob/master/SECURITY.md
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -277,7 +281,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.1
+rubygems_version: 3.0.3.1
+signing_key: 
 specification_version: 4
 summary: Secure Ruby client for Mathpix OCR API with MCP integration
 test_files: []