This MCP server exposes read-only tools for accessing the Watchtower Online Library (WOL) through the MCP protocol. The available tools are wol_search for advanced searching with operators and pagination, wol_get_document to retrieve a full document in Markdown form, and wol_browse_publications to list available publication types. You can run the server locally and connect to it via the MCP endpoint (for development, the repo’s Cloudflare-focused setup uses a local stdin transport). The basic local MCP endpoint is http://localhost:8787/sse. To use the tools, construct an MCP request targeting the wol server and the appropriate tool name, passing the required parameters as documented in the README. For example, a basic search might use wol_search with a query string and optional language, scope, and publications; retrieving a document requires the full WOL URL; and browsing publications requires specifying a type or language if desired. The server will respond with structured results, including document metadata, and document bodies will be provided in Markdown format. You can test via an MCP client or the included inspector tooling if using a local development setup.

Prerequisites:

• Node.js and npm installed on your system
• Git installed

Installation steps:

1. Clone the repository git clone https://github.com/LeomaiaJr/wol-mcp-server.git
2. Change into the project directory cd wol-mcp
3. Install dependencies npm install
4. Build the server npm run build
5. Run the server locally (development) npm start

   The MCP endpoint will typically be http://localhost:8787/sse

Optional

• Run type checks during development npm run type-check
• If you plan to deploy to a Cloudflare Workers-based remote MCP, follow the Cloudflare setup steps in the README and ensure you adapt the transport to HTTP/SSE as described.

Notes and tips:

• This MCP server is designed for read-only access to WOL; write operations are not exposed.
• Language and operator support are dynamic based on WOL and the server configuration.
• If upstream WOL availability is degraded, errors may surface as SERVICE_UNAVAILABLE; the client should handle retries.
• Environment variables available for basic debugging and log control include NODE_ENV and LOG_LEVEL; adjust as needed for production.
• The server uses a Node.js build output (dist/index.js); ensure you run the build step before starting the server in production.
• For remote MCP deployments via Cloudflare Workers, you’ll typically wire the same tools (wol_search, wol_get_document, wol_browse_publications) to the HTTP/SSE transport and point clients at the /sse endpoint.