hasolidit-mcp 0.0.1

package/.github/workflows/ci.yml

@@ -0,0 +1,80 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: npm
+      - run: npm ci
+      - run: npm run lint
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: npm
+      - run: npm ci
+      - name: Get Playwright version
+        id: pw
+        run: echo "version=$(npx playwright --version | awk '{print $2}')" >> "$GITHUB_OUTPUT"
+      - name: Cache Playwright browsers
+        uses: actions/cache@v4
+        id: playwright-cache
+        with:
+          path: ~/.cache/ms-playwright
+          key: playwright-${{ steps.pw.outputs.version }}-chromium
+      - name: Install Playwright Chromium
+        if: steps.playwright-cache.outputs.cache-hit != 'true'
+        run: npx playwright install chromium
+      - name: Install Playwright system deps
+        run: npx playwright install-deps chromium
+      - run: npx playwright test
+
+  publish:
+    needs: [lint, test]
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          registry-url: https://registry.npmjs.org
+      - name: Check if version changed
+        id: version
+        run: |
+          LOCAL=$(node -p "require('./package.json').version")
+          REMOTE=$(npm view hasolidit-mcp version 2>/dev/null || echo "0.0.0")
+          if [ "$LOCAL" != "$REMOTE" ]; then
+            echo "changed=true" >> "$GITHUB_OUTPUT"
+            echo "Version changed: $REMOTE → $LOCAL"
+          else
+            echo "changed=false" >> "$GITHUB_OUTPUT"
+            echo "Version unchanged: $LOCAL"
+          fi
+      - name: Publish to npm
+        if: steps.version.outputs.changed == 'true'
+        run: |
+          npm ci
+          npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.mcp.json

@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "playwright": {
+      "command": "npx",
+      "args": [
+        "@playwright/mcp@latest"
+      ]
+    }
+  }
+}

package/.nvmrc

@@ -0,0 +1 @@
+24

package/AGENTS.md

@@ -0,0 +1,33 @@
+# Hasolidit Forum MCP Server
+
+MCP server for the Hasolidit financial community forum (XenForo-based, Hebrew). Provides forum interaction tools via Playwright browser automation.
+
+## Stack
+
+- Node.js 24 with native TypeScript (no compile step)
+- `@modelcontextprotocol/sdk` for MCP server
+- Playwright for browser automation and DOM extraction
+- ESLint with typescript-eslint recommended
+
+## Structure
+
+- `src/index.ts` — MCP server entry point, tool definitions
+- `src/browser.ts` — shared Playwright browser lifecycle (one browser, context-per-call)
+- `src/tools/` — one file per MCP tool
+- `tests/` — Playwright E2E tests (see `tests/AGENTS.md`)
+- `fixtures/` — captured HTML for CI tests (see `fixtures/AGENTS.md`)
+- `scripts/` — utility scripts
+
+## Key patterns
+
+- Use `page.evaluate()` for DOM extraction (single pass, no per-element timeouts)
+- Create a new `BrowserContext` per tool call for cookie isolation
+- All URLs are resolved to absolute (`https://www.hasolidit.com/...`)
+- The MCP server version is read from `package.json` at runtime
+
+## Commands
+
+- `npm start` — run MCP server via stdio
+- `npm test` — run Playwright tests
+- `npm run lint` / `npm run lint:fix` — ESLint
+- `npm run fixtures:update` — recapture HTML fixtures from live site

package/LICENSE

@@ -0,0 +1,19 @@
+Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0)
+
+Copyright (c) 2026 Daniel Golub
+
+This work is licensed under the Creative Commons Attribution-NonCommercial 4.0
+International License. To view a copy of this license, visit
+https://creativecommons.org/licenses/by-nc/4.0/ or send a letter to Creative
+Commons, PO Box 1866, Mountain View, CA 94042, USA.
+
+You are free to:
+  - Share — copy and redistribute the material in any medium or format
+  - Adapt — remix, transform, and build upon the material
+
+Under the following terms:
+  - Attribution — You must give appropriate credit, provide a link to the
+    license, and indicate if changes were made.
+  - NonCommercial — You may not use the material for commercial purposes.
+  - No additional restrictions — You may not apply legal terms or technological
+    measures that legally restrict others from doing anything the license permits.

package/README.md

@@ -0,0 +1,83 @@
+# Hasolidit Forum MCP Server
+
+[![CI](https://github.com/danielgolub/mcp-hasolidit/actions/workflows/ci.yml/badge.svg)](https://github.com/danielgolub/mcp-hasolidit/actions/workflows/ci.yml)
+[![License: CC BY-NC 4.0](https://img.shields.io/badge/License-CC_BY--NC_4.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc/4.0/)
+[![Node.js](https://img.shields.io/badge/Node.js-24+-green.svg)](https://nodejs.org/)
+
+MCP server for interacting with the [Hasolidit](https://www.hasolidit.com/kehila/) financial community forum through AI tools (Claude Desktop, Claude Code, etc.).
+
+## Tools
+
+- **`search_forum`** — Search the forum. Returns titles, snippets, authors, dates, and links. Supports pagination.
+- **`view_thread`** — Read a thread's posts with author, date, and full text content. Supports pagination.
+- **`new_posts`** — Get the latest active threads with title, author, forum, reply/view counts, and last activity info.
+
+## Prerequisites
+
+- Node.js 24+ (uses native TypeScript support)
+- Playwright Chromium browser
+
+## Install
+
+```bash
+git clone <repo-url>
+cd hasolidit-mcp
+nvm use
+npm install
+npx playwright install chromium
+```
+
+## Add to Claude Code
+
+Add to your project's `.mcp.json` or `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "hasolidit": {
+      "command": "node",
+      "args": ["src/index.ts"],
+      "cwd": "/path/to/hasolidit-mcp"
+    }
+  }
+}
+```
+
+Then restart Claude Code or run `/mcp` to reload.
+
+## Add to Claude Desktop
+
+Claude Desktop doesn't support `cwd`, so use absolute paths for both the Node binary and the script.
+
+Open Settings > Developer > Edit Config and add:
+
+```json
+{
+  "mcpServers": {
+    "hasolidit": {
+      "command": "/path/to/.nvm/versions/node/v24.x.x/bin/node",
+      "args": ["/path/to/hasolidit-mcp/src/index.ts"]
+    }
+  }
+}
+```
+
+Replace `/path/to/.nvm/versions/node/v24.x.x` with your actual Node 24 path (run `nvm which 24` to find it).
+
+Then restart Claude Desktop.
+
+## Run tests
+
+```bash
+npx playwright test
+```
+
+## Disclaimer
+
+This project is an unofficial, independent tool that provides MCP access to the publicly available content on the [Hasolidit](https://www.hasolidit.com/) forum. It is not affiliated with, endorsed by, or associated with Hasolidit or its authors in any way.
+
+All forum content, including posts, threads, and user-generated material, belongs to their respective authors and to Hasolidit. This tool merely provides a programmatic interface to access publicly visible information — it does not store, copy, or redistribute any content.
+
+## License
+
+[CC BY-NC 4.0](LICENSE) — free to use and modify, not for commercial purposes.

package/eslint.config.js

@@ -0,0 +1,10 @@
+import eslint from "@eslint/js";
+import tseslint from "typescript-eslint";
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    ignores: ["node_modules/", "test-results/", ".playwright-mcp/"],
+  }
+);

package/fixtures/AGENTS.md

@@ -0,0 +1,25 @@
+# Fixtures
+
+Captured HTML snapshots from the live Hasolidit forum, used by CI tests.
+
+## Updating fixtures
+
+Always use the capture script — never edit fixture files manually:
+
+```bash
+npm run fixtures:update
+```
+
+This is the golden truth. The script (`scripts/capture-fixtures.ts`) opens a real browser, visits each page, waits for content to load, and saves the rendered HTML. Manual edits will be overwritten and may not reflect the real site structure.
+
+## Files
+
+- `search-results.html` — search results page for a sample query
+- `thread.html` — a thread with multiple posts and pages
+- `new-posts.html` — the "what's new" / recent posts page
+
+## When to update
+
+- When the site changes its HTML structure (tests will fail locally first)
+- When adding a new tool that needs a new fixture
+- Periodically to keep fixtures reasonably current