ask-web-search-mcp 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 74101b65000d8653c19c54ef6c086c7e8cff70e0d9d6d97b8326b9ea7c549b38
+  data.tar.gz: a635049085f7a01311ea6398a888af0e71770a7b78c7801cd52e6aedc3a03698
+SHA512:
+  metadata.gz: ec94b39fc0d04e542b1687a3ba765615a955c9913fcad3730c564d4c08622b9c9662b646bb0b674d8d163aaddf419ee60127fced6729917a2cd1123f0003ef72
+  data.tar.gz: 52d3567b53606f19617a12c75adf91641101eef917bf2ec01bee0a5cc74be429732785386a29d78343a2c0a6a699d5be5744f66bcb141d816d5c557e82d10982

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## [0.1.0] - 2026-07-18
+
+### Added
+
+- Initial release — minimal MCP server exposing the `web_search` tool backed by
+  SearXNG via `ask-web-search`.
+- Stdio transport via `Ask::MCP::Server.start_stdio`.
+- Configurable SearXNG URL via `SEARXNG_URL` environment variable (inherited
+  from `ask-web-search`).

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,86 @@
+# ask-web-search-mcp
+
+[![Gem Version](https://badge.fury.io/rb/ask-web-search-mcp.svg)](https://rubygems.org/gems/ask-web-search-mcp)
+
+A minimal [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) server
+that exposes a `web_search` tool backed by SearXNG. Designed for use with
+MCP-compatible clients like **ZCode**, **Claude Code**, **Codex**, and others.
+
+## Prerequisites
+
+A running [SearXNG](https://docs.searxng.org/) instance. The default endpoint
+is `http://localhost:8888`.
+
+```sh
+docker run -d --name searxng -p 8888:8080 searxng/searxng
+```
+
+Or use the provided `docker-compose.yml` in the [`searxng`](../searxng) directory:
+
+```sh
+cd searxng
+docker compose up -d
+```
+
+You can customise the SearXNG URL via the `SEARXNG_URL` environment variable.
+
+## Installation
+
+```sh
+gem install ask-web-search-mcp
+```
+
+Or in your Gemfile:
+
+```ruby
+gem "ask-web-search-mcp"
+```
+
+## Usage
+
+### Standalone
+
+```sh
+ask-web-search-mcp
+```
+
+The server reads JSON-RPC messages on stdin and writes responses to stdout
+(the standard MCP stdio transport).
+
+### With ZCode
+
+Add the server to your ZCode user configuration
+(`~/.zcode/v2/config.json`):
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "ask-web-search-mcp": {
+        "command": "ask-web-search-mcp"
+      }
+    }
+  }
+}
+```
+
+After restarting ZCode, the `web_search` tool will be available to the model.
+
+### With Claude Code
+
+```sh
+claude mcp add ask-web-search-mcp -- npx -y @anthropic-ai/mcp-serve ask-web-search-mcp
+```
+
+## Development
+
+```sh
+git clone https://github.com/ask-rb/ask-web-search-mcp
+cd ask-web-search-mcp
+bin/setup
+bundle exec rake test
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

data/bin/ask-web-search-mcp

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

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

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

data/lib/ask/web_search/mcp.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require "ask/mcp"
+require "ask/web_search"
+require_relative "mcp/version"
+
+module Ask
+  module WebSearch
+    module MCP
+      # Start the MCP server over stdio, exposing the WebSearch tool.
+      #
+      #   $ ask-web-search-mcp
+      #
+      # The server will listen for JSON-RPC messages on stdin and write
+      # responses to stdout — the standard MCP stdio transport.  Register
+      # this executable as an MCP server in your client configuration:
+      #
+      #   "mcp": {
+      #     "servers": {
+      #       "ask-web-search-mcp": {
+      #         "command": "ask-web-search-mcp",
+      #         "type": "stdio"
+      #       }
+      #     }
+      #   }
+      def self.start
+        Ask::MCP::Server.start_stdio(
+          name: "ask-web-search-mcp",
+          tools: [Ask::Tools::WebSearch.new],
+          capabilities: { tools: {} },
+          debug: ENV["DEBUG"] == "1"
+        )
+      end
+    end
+  end
+end

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

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "ask/web_search/mcp"

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification
+name: ask-web-search-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-search
+  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'
+description: |
+  A minimal MCP (Model Context Protocol) server that exposes Ask::Tools::WebSearch
+  as a callable tool over stdio. Designed for use with clients that support MCP
+  (ZCode, Claude Code, etc.), it queries a local SearXNG instance and returns
+  formatted search results suitable for LLM consumption.
+email:
+- kaka@myrrlabs.com
+executables:
+- ask-web-search-mcp
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- bin/ask-web-search-mcp
+- lib/ask-web-search-mcp.rb
+- lib/ask/web_search/mcp.rb
+- lib/ask/web_search/mcp/version.rb
+homepage: https://github.com/ask-rb/ask-web-search-mcp
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/ask-rb/ask-web-search-mcp
+  source_code_uri: https://github.com/ask-rb/ask-web-search-mcp
+  changelog_uri: https://github.com/ask-rb/ask-web-search-mcp/blob/master/CHANGELOG.md
+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 search via SearXNG
+test_files: []