ask-web-fetch-mcp 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1aa57d85315d18fe95c6db0a3eac3ee66cb5e74618e316de5fc248710fc2d5d3
+  data.tar.gz: 6597f0ee539ee331510baeeebeb72a1e6dc1a2b9d6a9812bf18348bc3c080f0b
+SHA512:
+  metadata.gz: 250774dd7ae46c7c137d4795a37372c3e92ff823de088ba990a2fa6ea6d35899e6646066c3218cbc6831f52fb02f816023ae1904a4b45c7af566a0ff182305f5
+  data.tar.gz: 8b57d4f583f1cf887031cf92697cf37dfa3638dbc15c49710f5a07c3e2ae116ebabeac673466373f098b79d7ed1c288c1247af98ee6d133706b316131daaab18

data/CHANGELOG.md

@@ -0,0 +1,8 @@
+## [0.1.0] — 2026-08-04
+
+### Added
+
+- Initial release: MCP (Model Context Protocol) server over stdio exposing
+  `Ask::Tools::WebFetch` as the `ask_web_fetch` tool.
+- Exposes the full backend chain (local pure-Ruby fetch with automatic Jina
+  Reader fallback) to any MCP client (ZCode, Claude Code, etc.).

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kaka Ruto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,77 @@
+# ask-web-fetch-mcp
+
+[![Gem Version](https://badge.fury.io/rb/ask-web-fetch-mcp.svg)](https://badge.fury.io/rb/ask-web-fetch-mcp)
+
+A minimal MCP (Model Context Protocol) server that exposes
+`Ask::Tools::WebFetch` as a callable tool over stdio. Designed for use with
+clients that support MCP (ZCode, Claude Code, etc.), it fetches a URL and
+returns clean markdown for LLM consumption — via the local pure-Ruby backend
+by default, with an automatic Jina Reader fallback for JS-rendered or blocked
+pages.
+
+## Installation
+
+```ruby
+gem "ask-web-fetch-mcp"
+```
+
+## Usage
+
+Run the server:
+
+```sh
+ask-web-fetch-mcp
+```
+
+The server listens for JSON-RPC messages on stdin and writes responses to
+stdout — the standard MCP stdio transport. Register it as an MCP server in
+your client configuration:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "ask-web-fetch-mcp": {
+        "type": "stdio",
+        "command": "ask-web-fetch-mcp",
+        "args": []
+      }
+    }
+  }
+}
+```
+
+The exposed tool is named `ask_web_fetch` (the `ask_` prefix avoids
+collisions with client-side tools of the same name, matching
+`ask-web-search-mcp`). It accepts a `url` argument and an optional
+`max_chars`, and returns the page content as markdown:
+
+```
+{"jsonrpc":"2.0","id":1,"method":"tools/call",
+ "params":{"name":"ask_web_fetch","arguments":{"url":"https://www.ruby-lang.org/en/"}}}
+```
+
+## Configuration
+
+The `ask-web-fetch` backend chain applies unchanged. Optional environment
+variables:
+
+- `JINA_API_KEY` — enables the Jina fallback with higher rate limits
+- `DEBUG=1` — ask-mcp debug logging on stderr
+
+## Full documentation
+
+The full ask-rb documentation lives at https://ask-rb.github.io/ask-docs.
+[Core: Web Fetch](https://ask-rb.github.io/ask-docs/core/web-fetch) covers
+ask-web-fetch in depth. API reference: https://ask-rb.github.io/ask-docs/reference/api.
+
+## Development
+
+```
+bundle install
+bundle exec rake test
+```
+
+## License
+
+MIT

data/bin/ask-web-fetch-mcp

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'ask/web_fetch/mcp'
+
+Ask::WebFetch::MCP.start

data/lib/ask/web_fetch/mcp/version.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Ask
+  module WebFetch
+    module MCP
+      VERSION = '0.1.0'
+    end
+  end
+end

data/lib/ask/web_fetch/mcp.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require 'ask/mcp'
+require 'ask/web_fetch'
+require_relative 'mcp/version'
+
+module Ask
+  module WebFetch
+    # MCP (Model Context Protocol) server for ask-web-fetch.
+    module MCP
+      # Builds the tool exposed over MCP: Ask::Tools::WebFetch renamed to
+      # "ask_web_fetch" to avoid collisions with client-side tools of the
+      # same name (ask-web-search-mcp follows the same convention).
+      def self.tool
+        tool = Ask::Tools::WebFetch.new
+        tool.define_singleton_method(:name) { 'ask_web_fetch' }
+        tool
+      end
+
+      # Start the MCP server over stdio, exposing the ask_web_fetch tool.
+      #
+      #   $ ask-web-fetch-mcp
+      #
+      # The server listens for JSON-RPC messages on stdin and writes
+      # responses to stdout — the standard MCP stdio transport. Register
+      # this executable as an MCP server in your client configuration:
+      #
+      #   "mcp": {
+      #     "servers": {
+      #       "ask-web-fetch-mcp": {
+      #         "type": "stdio",
+      #         "command": "ask-web-fetch-mcp",
+      #         "args": []
+      #       }
+      #     }
+      #   }
+      def self.start
+        Ask::MCP::Server.start_stdio(
+          name: 'ask-web-fetch-mcp',
+          tools: [tool],
+          capabilities: { tools: {} },
+          debug: ENV['DEBUG'] == '1'
+        )
+      end
+    end
+  end
+end

data/lib/ask-web-fetch-mcp.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative 'ask/web_fetch/mcp'

metadata

@@ -0,0 +1,126 @@
+--- !ruby/object:Gem::Specification
+name: ask-web-fetch-mcp
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kaka Ruto
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ask-mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: ask-web-fetch
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.26'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.26'
+description: |
+  A minimal MCP (Model Context Protocol) server that exposes Ask::Tools::WebFetch
+  as a callable tool over stdio. Designed for use with clients that support MCP
+  (ZCode, Claude Code, etc.), it fetches a URL and returns clean markdown via the
+  local pure-Ruby backend, with an automatic Jina Reader fallback.
+email:
+- kaka@myrrlabs.com
+executables:
+- ask-web-fetch-mcp
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- bin/ask-web-fetch-mcp
+- lib/ask-web-fetch-mcp.rb
+- lib/ask/web_fetch/mcp.rb
+- lib/ask/web_fetch/mcp/version.rb
+homepage: https://github.com/ask-rb/ask-web-fetch-mcp
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/ask-rb/ask-web-fetch-mcp
+  source_code_uri: https://github.com/ask-rb/ask-web-fetch-mcp
+  changelog_uri: https://github.com/ask-rb/ask-web-fetch-mcp/blob/master/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: MCP server for web fetch
+test_files: []