nusus-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Nusus contributors
+
+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.

package/README.md

@@ -0,0 +1,48 @@
+# nusus-mcp
+
+Local [Model Context Protocol](https://modelcontextprotocol.io/) stdio server for searching and citing classical Islamic and Arabic texts through Nusus and Turath.
+
+## Claude Desktop
+
+Node.js 20+ is required. Add this to `claude_desktop_config.json`, then restart Claude Desktop:
+
+```json
+{
+  "mcpServers": {
+    "nusus": {
+      "command": "npx",
+      "args": ["-y", "nusus-mcp"]
+    }
+  }
+}
+```
+
+`npx` downloads the npm package automatically; users do not need to clone this repository. Claude Desktop may start with a limited `PATH`. If it cannot find `npx`, replace `"npx"` with the absolute path printed by `which npx` (macOS/Linux) or `where.exe npx` (Windows).
+
+The server uses stdio only and writes protocol messages to stdout. It calls Turath's public API for live tools; `find_books` and `find_authors` use Nusus's bundled offline catalog.
+
+## Tools
+
+| Tool | Purpose and arguments |
+| --- | --- |
+| `find_books` | Find books offline. Required `query` (may be empty with a filter); optional `authorId`, `categoryId`, `limit`. |
+| `find_authors` | Find authors offline. Required `query`; optional `limit`. |
+| `retrieve` | Retrieve bounded, citable passages. Required `query`; optional `bookId`, `authorId`, `categoryId`, `maxPassages`, `maxCharsPerPassage`, `pagesBefore`, `pagesAfter`. |
+| `get_context` | Get an internal Turath page with adjacent context. Required `bookId`, `pageId`; optional `pagesBefore`, `pagesAfter`. |
+| `get_book` | Get book metadata and table of contents. Required `bookId`. |
+
+Each live search filter accepts at most one ID. `pageId` is Turath's internal page ID, not the printed page.
+
+## Development
+
+`nusus-mcp` declares the publishable dependency `"nusus": "^0.6.0"`. Because the SDK package is the workspace root rather than a child workspace, Bun resolves that dependency from npm instead of linking the local root. Until `nusus@0.6.0` is published, keep the existing install for local verification; after publishing it, run:
+
+```bash
+bun install
+bun run build
+(cd mcp && bun run build && bun run typecheck && bun run test)
+```
+
+Publish `nusus@0.6.0` before publishing `nusus-mcp@0.1.0` so fresh installs can resolve the SDK dependency.
+
+`NUSUS_TURATH_BASE_URL` overrides the Turath API base URL, primarily for fixture-backed tests.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { NususError } from "nusus";
+import { createTurathClient } from "nusus/turath";
+const positiveInteger = (args, key, required = false) => {
+    const value = args[key];
+    if (value === undefined && !required)
+        return undefined;
+    if (!Number.isInteger(value) || value < 1)
+        throw new NususError("INVALID_ARGUMENT", `${key} must be a positive integer`);
+    return value;
+};
+const nonNegativeInteger = (args, key) => {
+    const value = args[key];
+    if (value === undefined)
+        return undefined;
+    if (!Number.isInteger(value) || value < 0)
+        throw new NususError("INVALID_ARGUMENT", `${key} must be a non-negative integer`);
+    return value;
+};
+const stringArgument = (args, key) => {
+    const value = args[key];
+    if (typeof value !== "string")
+        throw new NususError("INVALID_ARGUMENT", `${key} must be a string`);
+    return value;
+};
+const optional = (values) => Object.fromEntries(Object.entries(values).filter(([, value]) => value !== undefined));
+const baseUrl = process.env.NUSUS_TURATH_BASE_URL;
+const turath = createTurathClient(baseUrl ? { baseUrl } : {});
+const tools = [
+    {
+        name: "find_books",
+        description: "Find books in Nusus's bundled offline Turath catalog by Arabic title and optional single author/category filters.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Title query; may be empty when authorId or categoryId is provided." },
+                authorId: { type: "integer", minimum: 1 },
+                categoryId: { type: "integer", minimum: 1 },
+                limit: { type: "integer", minimum: 1 },
+            },
+            required: ["query"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "find_authors",
+        description: "Find authors by Arabic name in Nusus's bundled offline Turath catalog.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", minLength: 1 },
+                limit: { type: "integer", minimum: 1 },
+            },
+            required: ["query"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "retrieve",
+        description: "Retrieve bounded, citable Turath passages. Each filter accepts at most one ID because that is the verified upstream limit.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", minLength: 1 },
+                bookId: { type: "integer", minimum: 1 },
+                authorId: { type: "integer", minimum: 1 },
+                categoryId: { type: "integer", minimum: 1 },
+                maxPassages: { type: "integer", minimum: 1 },
+                maxCharsPerPassage: { type: "integer", minimum: 1 },
+                pagesBefore: { type: "integer", minimum: 0 },
+                pagesAfter: { type: "integer", minimum: 0 },
+            },
+            required: ["query"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "get_context",
+        description: "Get one Turath page with optional adjacent pages. pageId is Turath's internal page ID, not the printed page.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                bookId: { type: "integer", minimum: 1 },
+                pageId: { type: "integer", minimum: 1 },
+                pagesBefore: { type: "integer", minimum: 0 },
+                pagesAfter: { type: "integer", minimum: 0 },
+            },
+            required: ["bookId", "pageId"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "get_book",
+        description: "Get Turath book metadata and table of contents by book ID.",
+        inputSchema: {
+            type: "object",
+            properties: { bookId: { type: "integer", minimum: 1 } },
+            required: ["bookId"],
+            additionalProperties: false,
+        },
+    },
+];
+const jsonContent = (value, isError = false) => ({
+    content: [{ type: "text", text: JSON.stringify(value) }],
+    ...(isError && { isError: true }),
+});
+const runTool = async (name, args) => {
+    switch (name) {
+        case "find_books": {
+            const authorId = positiveInteger(args, "authorId");
+            const categoryId = positiveInteger(args, "categoryId");
+            return turath.findBooks(stringArgument(args, "query"), optional({
+                authorIds: authorId === undefined ? undefined : [authorId],
+                categoryIds: categoryId === undefined ? undefined : [categoryId],
+                limit: positiveInteger(args, "limit"),
+            }));
+        }
+        case "find_authors":
+            return turath.findAuthors(stringArgument(args, "query"), optional({ limit: positiveInteger(args, "limit") }));
+        case "retrieve": {
+            const bookId = positiveInteger(args, "bookId");
+            const authorId = positiveInteger(args, "authorId");
+            const categoryId = positiveInteger(args, "categoryId");
+            const scope = optional({
+                bookIds: bookId === undefined ? undefined : [bookId],
+                authorIds: authorId === undefined ? undefined : [authorId],
+                categoryIds: categoryId === undefined ? undefined : [categoryId],
+            });
+            return turath.retrieve(stringArgument(args, "query"), optional({
+                scope: Object.keys(scope).length ? scope : undefined,
+                maxPassages: positiveInteger(args, "maxPassages"),
+                maxCharsPerPassage: positiveInteger(args, "maxCharsPerPassage"),
+                pagesBefore: nonNegativeInteger(args, "pagesBefore"),
+                pagesAfter: nonNegativeInteger(args, "pagesAfter"),
+            }));
+        }
+        case "get_context":
+            return turath.getContextByPage(positiveInteger(args, "bookId", true), positiveInteger(args, "pageId", true), optional({
+                pagesBefore: nonNegativeInteger(args, "pagesBefore"),
+                pagesAfter: nonNegativeInteger(args, "pagesAfter"),
+            }));
+        case "get_book":
+            return turath.getBook(positiveInteger(args, "bookId", true));
+        default:
+            throw new NususError("INVALID_ARGUMENT", `Unknown tool: ${name}`);
+    }
+};
+const server = new Server({ name: "nusus-mcp", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [...tools] }));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    try {
+        return jsonContent(await runTool(request.params.name, request.params.arguments ?? {}));
+    }
+    catch (error) {
+        if (error instanceof NususError)
+            return jsonContent({ code: error.code, message: error.message }, true);
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return jsonContent({ code: "INTERNAL", message }, true);
+    }
+});
+try {
+    await server.connect(new StdioServerTransport());
+}
+catch (error) {
+    process.stderr.write(`nusus-mcp failed: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "nusus-mcp",
+  "version": "0.1.0",
+  "description": "Local MCP stdio server for Nusus and Turath",
+  "keywords": [
+    "turath",
+    "shamela",
+    "maktaba-shamela",
+    "islamic-texts",
+    "arabic-books",
+    "hadith",
+    "fiqh",
+    "typescript",
+    "sdk",
+    "cli",
+    "jsonl",
+    "mcp",
+    "model-context-protocol",
+    "agents"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mwijanarko1/nusus.git",
+    "directory": "mcp"
+  },
+  "homepage": "https://github.com/mwijanarko1/nusus#readme",
+  "bugs": "https://github.com/mwijanarko1/nusus/issues",
+  "type": "module",
+  "bin": {
+    "nusus-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepack": "npm run build",
+    "test": "bun run build && bun test tests",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "nusus": "^0.6.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT"
+}