ask-web-search-mcp 0.2.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f160f5a8fb458d0709056a11c582668c7635a5eaaaf85d9be6874177eba701ac
-  data.tar.gz: 846c889c1942698894bb3d5af8b385ee54c775d6b1d355ebe62227cb39a46539
+  metadata.gz: 51082bc819e6a1339ee7ff5910271207bfe64d14b04491cf4b3d07e7c51bd1f9
+  data.tar.gz: 58506846d0d4699a95bd2e9cb499a4cf2b5a18b662bd1fc16b07eecf71e02d5f
 SHA512:
-  metadata.gz: badf1176d59f3b255a7fd66b89c5a772c6bcb8fea3b4bb94bf1ce1a1d49f6d031fe8c2cfaf9f135a1f965dcaed758e7fa2222de7168d6d80cf42d5f5731364ea
-  data.tar.gz: 821fc274ee6ea451359afedacca24bc319a532bf10a6b67b1a458345194a89227d457d255432020eb1feb86e03908d774cc2da3785db84d7ef0eccbc71f2728c
+  metadata.gz: 7efeb497e046762da0649d6eb498853892054d55a05a1dbf1631ba2e6c4f695d3303dc1afbaac94c0a65c4fdeefbbedb767ee4502984c058f6590ead2ad04a96
+  data.tar.gz: 26a47fca4064effd03d08cbacd2e161f64d0ff5d0bc0d82fcc37ce6b95221a1f30ee2f2c1e058d8f1a867c7941a5034450f71967bdc7c428ba5fcdb619d5f284

data/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## [0.3.1] - 2026-08-04
+
+### Fixed
+
+- Corrected publish of the 0.3.0 changeset (0.3.0 was yanked — it shipped a
+  stale build missing the `tool` extraction and serverInfo version
+  passthrough). 0.3.1 is the same changeset built correctly.
+
+## [0.3.0] - 2026-08-04
+
+### Changed
+
+- **Stateless protocol support (2026-07-28)** — the server now negotiates the
+  stateless MCP revision via `server/discover` (no `initialize` handshake,
+  per-request `_meta`, `resultType`) when the client supports it, while
+  remaining backward compatible with legacy `initialize`-handshake clients.
+  Requires `ask-mcp >= 0.4` — the 0.4 line also brings server-side
+  resources/prompts and the Streamable HTTP rework.
+- Development resolves `ask-mcp` from rubygems via the `>= 0.4` floor — no
+  local path overrides; the server always exercises the published protocol
+  support.
+
+### Added
+
+- Functional test suite (`test/server_test.rb`) driving the server end-to-end
+  with `Ask::MCP::Client` over a real stdio subprocess: stateless
+  negotiation, tool listing, tool calls against a stubbed SearXNG (in-process
+  `FakeSearxng`), no-results handling, unknown-tool errors, and a
+  SearXNG-unreachable error path.
+- `Ask::WebSearch::MCP.tool` — extracted, testable accessor for the
+  `ask_web_search` tool instance, with unit tests covering the MCP tool
+  contract (name, description, params schema).
+- The server now reports its own gem version in the MCP `serverInfo`
+  handshake (via `ask-mcp >= 0.4.3`), instead of ask-mcp's version.
+
 ## [0.2.0] - 2026-07-18
 
 ### Changed

data/README.md

@@ -2,9 +2,18 @@
 
 [![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 an `ask_web_search` tool backed by SearXNG. Designed for use with
-MCP-compatible clients like **ZCode**, **Claude Code**, **Codex**, and others.
+A minimal [MCP](https://modelcontextprotocol.io/) (Model Context Protocol)
+server that exposes an `ask_web_search` tool backed by SearXNG. Designed for
+use with MCP-compatible clients like ZCode, Claude Code, Codex, and others.
+
+The server speaks MCP **dual-mode** (requires `ask-mcp >= 0.4`): it negotiates
+the stateless `2026-07-28` revision via `server/discover` (no `initialize`
+handshake, per-request `_meta`, `resultType`) when the client supports it, and
+falls back to the legacy `initialize` handshake for older clients.
+
+The tool was renamed from `web_search` to `ask_web_search` in version 0.2.0 to
+avoid collisions with client-side tools. Use `ask_web_search` in your
+configuration and prompts.
 
 ## Prerequisites
 
@@ -15,15 +24,14 @@ is `http://localhost:8888`.
 docker run -d --name searxng -p 8888:8080 searxng/searxng
 ```
 
-Or use the provided `docker-compose.yml` in the [`searxng`](../searxng) directory:
+Or use the provided `docker-compose.yml` in the `searxng` directory of this
+repository:
 
 ```sh
 cd searxng
 docker compose up -d
 ```
 
-You can customise the SearXNG URL via the `SEARXNG_URL` environment variable.
-
 ## Installation
 
 ```sh
@@ -49,8 +57,8 @@ The server reads JSON-RPC messages on stdin and writes responses to stdout
 
 ### With ZCode
 
-Add the server to your ZCode user configuration
-(`~/.zcode/v2/config.json`):
+Add to your ZCode user configuration (`~/.zcode/v2/config.json` or
+`~/.zcode/cli/config.json`):
 
 ```json
 {
@@ -66,7 +74,8 @@ Add the server to your ZCode user configuration
 }
 ```
 
-After restarting ZCode, the `ask_web_search` tool will be available to the model.
+After restarting ZCode, the `ask_web_search` tool will be available to the
+model automatically.
 
 ### With Claude Code
 
@@ -74,15 +83,30 @@ After restarting ZCode, the `ask_web_search` tool will be available to the model
 claude mcp add ask-web-search-mcp -- npx -y @anthropic-ai/mcp-serve ask-web-search-mcp
 ```
 
+## Configuration
+
+- `SEARXNG_URL` - the SearXNG endpoint (default: `http://localhost:8888`).
+- `DEBUG=1` - enable verbose logs on stderr.
+
+## Full documentation
+
+The full ask-rb documentation lives at https://ask-rb.github.io/ask-docs.
+[Core: Web Search](https://ask-rb.github.io/ask-docs/core/web-search) covers
+ask-web-search-mcp in depth, including the tool library and troubleshooting.
+API reference: https://ask-rb.github.io/ask-docs/reference/api.
+
 ## Development
 
-```sh
-git clone https://github.com/ask-rb/ask-web-search-mcp
-cd ask-web-search-mcp
-bin/setup
+```
+bundle install
 bundle exec rake test
 ```
 
+`ask-mcp` resolves from rubygems (`>= 0.4` — the 0.4 line carries the
+stateless 2026-07-28 protocol support). The suite drives the server
+end-to-end with `Ask::MCP::Client` over a real stdio subprocess, stubbing
+SearXNG in-process (no network required).
+
 ## License
 
-MIT — see [LICENSE](LICENSE).
+MIT

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

@@ -3,7 +3,7 @@
 module Ask
   module WebSearch
     module MCP
-      VERSION = "0.2.0"
+      VERSION = "0.3.1"
     end
   end
 end

data/lib/ask/web_search/mcp.rb

@@ -7,6 +7,15 @@ require_relative "mcp/version"
 module Ask
   module WebSearch
     module MCP
+      # Builds the tool exposed over MCP: Ask::Tools::WebSearch renamed to
+      # "ask_web_search" to avoid collisions with client-side tools of the
+      # same name.
+      def self.tool
+        tool = Ask::Tools::WebSearch.new
+        tool.define_singleton_method(:name) { "ask_web_search" }
+        tool
+      end
+
       # Start the MCP server over stdio, exposing the ask_web_search tool.
       #
       #   $ ask-web-search-mcp
@@ -25,11 +34,9 @@ module Ask
       #     }
       #   }
       def self.start
-        tool = Ask::Tools::WebSearch.new
-        tool.define_singleton_method(:name) { "ask_web_search" }
-
         Ask::MCP::Server.start_stdio(
           name: "ask-web-search-mcp",
+          version: VERSION,
           tools: [tool],
           capabilities: { tools: {} },
           debug: ENV["DEBUG"] == "1"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-web-search-mcp
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Kaka Ruto
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: 0.4.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: 0.4.3
 - !ruby/object:Gem::Dependency
   name: ask-web-search
   requirement: !ruby/object:Gem::Requirement