@metaneutrons/doc-tools-mcp 0.1.0

package/README.md

@@ -0,0 +1,118 @@
+# Doc Tools MCP Server
+
+[![CI](https://github.com/metaneutrons/doc-tools-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/metaneutrons/doc-tools-mcp/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/@metaneutrons/doc-tools-mcp)](https://www.npmjs.com/package/@metaneutrons/doc-tools-mcp)
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D22.0.0-brightgreen)](https://nodejs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://www.typescriptlang.org/)
+[![MCP](https://img.shields.io/badge/MCP-1.26-purple)](https://modelcontextprotocol.io/)
+
+> **⚠️ Work in Progress** — APIs may change without notice.
+
+A [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server for managing [pandoc](https://pandoc.org/)/CSL-YAML bibliographies. Lets your LLM read, search, add, update, delete, and validate citation entries directly.
+
+## Quick Start
+
+```bash
+npx @metaneutrons/doc-tools-mcp
+```
+
+Add to your MCP client config (e.g., `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "doc-tools": {
+      "command": "npx",
+      "args": ["-y", "@metaneutrons/doc-tools-mcp"]
+    }
+  }
+}
+```
+
+> All `bib:*` tools take a `file` parameter — the path to your CSL-YAML bibliography file.
+> The LLM discovers this automatically from `bibliography:` in `pandoc.yaml` or the YAML frontmatter of your `.md` files.
+
+## Tools
+
+### Read
+
+| Tool | Description |
+|------|-------------|
+| `bib:get` | Retrieve a single entry by ID (full YAML block) |
+| `bib:search` | Full-text search across all fields: author, title, type, year, editor, container-title |
+| `bib:list` | List all entries of a given type (e.g., `legal_case`, `chapter`, `article-journal`) |
+| `bib:exists` | Check if an ID exists (fast boolean check before citing) |
+| `bib:stats` | Entry count total and breakdown by CSL type |
+
+### Write
+
+| Tool | Description |
+|------|-------------|
+| `bib:add` | Add a new entry with duplicate ID check, required field validation per CSL type, and YAML confirmation output |
+| `bib:update` | Patch individual fields of an existing entry (other fields remain untouched) |
+| `bib:delete` | Remove an entry by ID |
+
+### Validation
+
+| Tool | Description |
+|------|-------------|
+| `bib:validate` | Check entire file: YAML syntax, required fields per CSL type, duplicate IDs, missing `issued` dates |
+
+All write operations automatically create a `.bak` backup before modifying the file.
+
+## Supported CSL Types
+
+Required field validation is provided for these types:
+
+| Type | Required Fields |
+|------|----------------|
+| `legal_case` | `title`, `authority`, `number`, `issued` |
+| `book` | `title`, `issued` |
+| `article-journal` | `title`, `container-title`, `issued` |
+| `chapter` | `title`, `container-title`, `issued` |
+| `legislation` | `title`, `issued` |
+| `thesis` | `title`, `issued` |
+
+Other types are accepted without required field validation.
+
+## Architecture
+
+```
+src/
+├── index.ts                    # MCP server with dynamic provider loading
+├── shared/
+│   ├── types.ts                # Provider interface, ToolDefinition, ToolResult
+│   ├── logger.ts               # Structured logging (pino → stderr)
+│   └── errors.ts               # Typed error hierarchy
+└── providers/
+    └── bib/                    # Bibliography provider
+        ├── index.ts            # Provider implementation (9 tool handlers)
+        ├── store.ts            # YAML read/write with .bak backup
+        ├── schema.ts           # Zod schemas + per-type field validation
+        └── tools/              # Tool definitions (read + write)
+```
+
+The provider system is extensible — add a new directory under `src/providers/` with a `createProvider()` export and it will be auto-discovered at startup.
+
+## Development
+
+```bash
+npm install           # Install dependencies
+npm run build         # Compile TypeScript
+npm test              # Run tests
+npm run test:watch    # Watch mode
+npm run test:coverage # Coverage report
+npm run lint          # ESLint
+```
+
+### Commit Convention
+
+This repo uses [Conventional Commits](https://www.conventionalcommits.org/) enforced via Husky + commitlint.
+
+**Types:** `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `chore`, `ci`, `build`, `revert`
+**Scopes:** `bib`, `core`, `deps`, `config`
+
+## License
+
+GPL-3.0 — See [LICENSE](LICENSE) for details.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,116 @@
+#!/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 { rootLogger } from './shared/logger.js';
+import { readFileSync, readdirSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+if (process.argv.includes('--version') || process.argv.includes('-v')) {
+    console.log(packageJson.version);
+    process.exit(0);
+}
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    console.log(`
+Doc Tools MCP Server v${packageJson.version}
+
+A Model Context Protocol server for managing pandoc/CSL-YAML bibliographies.
+
+USAGE:
+  node dist/index.js [OPTIONS]
+
+OPTIONS:
+  -h, --help       Print this help message
+  -v, --version    Print version number
+`);
+    process.exit(0);
+}
+// Provider registry
+const providers = new Map();
+async function registerProvider(provider) {
+    providers.set(provider.name, provider);
+    if (provider.initialize)
+        await provider.initialize();
+}
+function getAllTools() {
+    return Array.from(providers.values()).flatMap((p) => p.getTools());
+}
+async function handleToolCall(toolName, args) {
+    const colonIndex = toolName.indexOf(':');
+    if (colonIndex === -1) {
+        return { content: [{ type: 'text', text: `Unknown tool: ${toolName}` }], isError: true };
+    }
+    const prefix = toolName.substring(0, colonIndex);
+    const provider = providers.get(prefix);
+    if (!provider) {
+        return { content: [{ type: 'text', text: `Unknown provider: ${prefix}` }], isError: true };
+    }
+    return provider.handleToolCall(toolName, args);
+}
+// Create MCP server
+const server = new Server({ name: 'doc-tools-mcp', version: packageJson.version }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: getAllTools().map((tool) => ({
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.inputSchema.toJSONSchema(),
+    })),
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const startTime = Date.now();
+    rootLogger.info('Tool call', { tool: name });
+    try {
+        const result = await handleToolCall(name, args ?? {});
+        rootLogger.info('Tool call completed', { tool: name, duration: Date.now() - startTime });
+        return { content: result.content, isError: result.isError };
+    }
+    catch (error) {
+        rootLogger.error('Tool call failed', error, { tool: name, duration: Date.now() - startTime });
+        return {
+            content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+            isError: true,
+        };
+    }
+});
+// Graceful shutdown
+let isShuttingDown = false;
+async function cleanup(signal) {
+    if (isShuttingDown)
+        return;
+    isShuttingDown = true;
+    rootLogger.info('Shutdown', { signal });
+    for (const provider of providers.values()) {
+        await provider.shutdown();
+    }
+    process.exit(0);
+}
+process.on('SIGINT', () => cleanup('SIGINT'));
+process.on('SIGTERM', () => cleanup('SIGTERM'));
+process.stdin.on('close', () => cleanup('stdin close'));
+// Dynamic provider loading
+const providersDir = join(__dirname, 'providers');
+for (const entry of readdirSync(providersDir, { withFileTypes: true })) {
+    if (!entry.isDirectory())
+        continue;
+    try {
+        const mod = await import(`./providers/${entry.name}/index.js`);
+        if (typeof mod.createProvider === 'function') {
+            const provider = mod.createProvider();
+            if (provider) {
+                await registerProvider(provider);
+                rootLogger.info(`Provider registered: ${provider.name}`);
+            }
+        }
+    }
+    catch (error) {
+        rootLogger.error(`Failed to load provider: ${entry.name}`, error);
+    }
+}
+const transport = new StdioServerTransport();
+await server.connect(transport);
+rootLogger.info('MCP server connected and ready');
+//# 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/dist/providers/bib/index.d.ts

@@ -0,0 +1,2 @@
+import { Provider } from '../../shared/types.js';
+export declare function createProvider(): Provider | null;

package/dist/providers/bib/index.js

@@ -0,0 +1,166 @@
+import yaml from 'js-yaml';
+import { rootLogger } from '../../shared/logger.js';
+import { NotFoundError, DuplicateError } from '../../shared/errors.js';
+import { BibStore } from './store.js';
+import { validateRequiredFields, validateBibliography } from './schema.js';
+import { bibTools } from './tools/index.js';
+const logger = rootLogger.child({ module: 'bib' });
+/** Serialize a single entry to YAML for display */
+function entryToYaml(entry) {
+    return yaml.dump([entry], { indent: 2, lineWidth: -1, noRefs: true, quotingType: '"', forceQuotes: false }).trim();
+}
+/** Flatten all string values of an entry for full-text search */
+function flattenEntry(entry) {
+    const parts = [];
+    const walk = (obj) => {
+        if (typeof obj === 'string')
+            parts.push(obj);
+        else if (typeof obj === 'number')
+            parts.push(String(obj));
+        else if (Array.isArray(obj))
+            obj.forEach(walk);
+        else if (obj && typeof obj === 'object')
+            Object.values(obj).forEach(walk);
+    };
+    walk(entry);
+    return parts.join(' ').toLowerCase();
+}
+class BibProvider {
+    name = 'bib';
+    store = new BibStore();
+    getTools() {
+        return bibTools;
+    }
+    async handleToolCall(toolName, args) {
+        try {
+            switch (toolName) {
+                case 'bib:get': return await this.handleGet(args);
+                case 'bib:search': return await this.handleSearch(args);
+                case 'bib:list': return await this.handleList(args);
+                case 'bib:exists': return await this.handleExists(args);
+                case 'bib:stats': return await this.handleStats(args);
+                case 'bib:add': return await this.handleAdd(args);
+                case 'bib:update': return await this.handleUpdate(args);
+                case 'bib:delete': return await this.handleDelete(args);
+                case 'bib:validate': return await this.handleValidate(args);
+                default:
+                    return { content: [{ type: 'text', text: `Unknown tool: ${toolName}` }], isError: true };
+            }
+        }
+        catch (error) {
+            logger.error('Tool call failed', error, { tool: toolName });
+            const message = error instanceof Error ? error.toString() : String(error);
+            return { content: [{ type: 'text', text: message }], isError: true };
+        }
+    }
+    async shutdown() {
+        logger.info('Bib provider shutdown');
+    }
+    // --- Read tools ---
+    async handleGet(args) {
+        const { file, id } = args;
+        const entry = await this.store.get(file, id);
+        if (!entry)
+            throw new NotFoundError(id);
+        return { content: [{ type: 'text', text: entryToYaml(entry) }] };
+    }
+    async handleSearch(args) {
+        const { file, query, limit = 20 } = args;
+        const entries = await this.store.read(file);
+        const q = query.toLowerCase();
+        const matches = entries.filter((e) => flattenEntry(e).includes(q)).slice(0, limit);
+        if (matches.length === 0) {
+            return { content: [{ type: 'text', text: `No entries found for "${query}"` }] };
+        }
+        const text = `Found ${matches.length} result(s) for "${query}":\n\n` +
+            matches.map((e) => `- **${e.id}** (${e.type}): ${e.title ?? '(no title)'}`).join('\n');
+        return { content: [{ type: 'text', text }] };
+    }
+    async handleList(args) {
+        const { file, type, limit = 50 } = args;
+        const entries = await this.store.read(file);
+        const matches = entries.filter((e) => e.type === type).slice(0, limit);
+        const total = entries.filter((e) => e.type === type).length;
+        if (matches.length === 0) {
+            return { content: [{ type: 'text', text: `No entries of type "${type}"` }] };
+        }
+        const text = `${total} entries of type "${type}"` +
+            (total > limit ? ` (showing first ${limit})` : '') + ':\n\n' +
+            matches.map((e) => `- **${e.id}**: ${e.title ?? '(no title)'}`).join('\n');
+        return { content: [{ type: 'text', text }] };
+    }
+    async handleExists(args) {
+        const { file, id } = args;
+        const exists = await this.store.exists(file, id);
+        return { content: [{ type: 'text', text: exists ? `✅ "${id}" exists` : `❌ "${id}" not found` }] };
+    }
+    async handleStats(args) {
+        const { file } = args;
+        const entries = await this.store.read(file);
+        const byType = {};
+        for (const e of entries) {
+            byType[e.type] = (byType[e.type] ?? 0) + 1;
+        }
+        const sorted = Object.entries(byType).sort(([, a], [, b]) => b - a);
+        const text = `Total entries: ${entries.length}\n\n` +
+            sorted.map(([type, count]) => `- ${type}: ${count}`).join('\n');
+        return { content: [{ type: 'text', text }] };
+    }
+    // --- Write tools ---
+    async handleAdd(args) {
+        const { file, entry } = args;
+        // Duplicate check
+        if (await this.store.exists(file, entry.id)) {
+            throw new DuplicateError(entry.id);
+        }
+        // Required field validation
+        const issues = validateRequiredFields(entry);
+        if (issues.some((i) => i.severity === 'error')) {
+            const text = 'Validation errors:\n' + issues.map((i) => `- ${i.message}`).join('\n');
+            return { content: [{ type: 'text', text }], isError: true };
+        }
+        await this.store.add(file, entry);
+        const text = `✅ Entry "${entry.id}" added.\n\n${entryToYaml(entry)}`;
+        return { content: [{ type: 'text', text }] };
+    }
+    async handleUpdate(args) {
+        const { file, id, fields } = args;
+        if (!(await this.store.exists(file, id))) {
+            throw new NotFoundError(id);
+        }
+        const updated = await this.store.update(file, id, fields);
+        const text = `✅ Entry "${id}" updated.\n\n${entryToYaml(updated)}`;
+        return { content: [{ type: 'text', text }] };
+    }
+    async handleDelete(args) {
+        const { file, id } = args;
+        if (!(await this.store.exists(file, id))) {
+            throw new NotFoundError(id);
+        }
+        await this.store.delete(file, id);
+        return { content: [{ type: 'text', text: `✅ Entry "${id}" deleted.` }] };
+    }
+    async handleValidate(args) {
+        const { file } = args;
+        const entries = await this.store.read(file);
+        const issues = validateBibliography(entries);
+        if (issues.length === 0) {
+            return { content: [{ type: 'text', text: `✅ Bibliography is valid. ${entries.length} entries, no issues found.` }] };
+        }
+        const errors = issues.filter((i) => i.severity === 'error');
+        const warnings = issues.filter((i) => i.severity === 'warning');
+        let text = `Validation results for ${entries.length} entries:\n`;
+        text += `- ${errors.length} error(s), ${warnings.length} warning(s)\n\n`;
+        if (errors.length > 0) {
+            text += '**Errors:**\n' + errors.map((i) => `- [${i.id}] ${i.message}`).join('\n') + '\n\n';
+        }
+        if (warnings.length > 0) {
+            text += '**Warnings:**\n' + warnings.map((i) => `- [${i.id}] ${i.message}`).join('\n');
+        }
+        return { content: [{ type: 'text', text }] };
+    }
+}
+export function createProvider() {
+    return new BibProvider();
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/bib/index.js.map

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

package/dist/providers/bib/schema.d.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+/** All CSL types we validate required fields for */
+export declare const CSL_TYPES: readonly ["article-journal", "book", "chapter", "legal_case", "legislation", "thesis", "report", "paper-conference", "webpage", "no-type"];
+export type CslType = typeof CSL_TYPES[number];
+/** Single CSL-YAML entry */
+export declare const cslEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        family: z.ZodString;
+        given: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    editor: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        family: z.ZodString;
+        given: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    issued: z.ZodOptional<z.ZodObject<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodNumber>>>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    'container-title': z.ZodOptional<z.ZodString>;
+    volume: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodString>;
+    publisher: z.ZodOptional<z.ZodString>;
+    'publisher-place': z.ZodOptional<z.ZodString>;
+    edition: z.ZodOptional<z.ZodString>;
+    authority: z.ZodOptional<z.ZodString>;
+    number: z.ZodOptional<z.ZodString>;
+    genre: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type CslEntry = z.infer<typeof cslEntrySchema>;
+export interface ValidationIssue {
+    id: string;
+    field?: string;
+    message: string;
+    severity: 'error' | 'warning';
+}
+/** Validate required fields for a given CSL type */
+export declare function validateRequiredFields(entry: CslEntry): ValidationIssue[];
+/** Validate an entire bibliography */
+export declare function validateBibliography(entries: CslEntry[]): ValidationIssue[];

package/dist/providers/bib/schema.js

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+/** All CSL types we validate required fields for */
+export const CSL_TYPES = [
+    'article-journal', 'book', 'chapter', 'legal_case', 'legislation',
+    'thesis', 'report', 'paper-conference', 'webpage', 'no-type',
+];
+/** CSL name variable (author, editor) */
+const cslNameSchema = z.object({
+    family: z.string(),
+    given: z.string().optional(),
+}).passthrough();
+/** CSL date variable */
+const cslDateSchema = z.object({
+    'date-parts': z.array(z.array(z.number())).optional(),
+    literal: z.string().optional(),
+}).passthrough();
+/** Single CSL-YAML entry */
+export const cslEntrySchema = z.object({
+    id: z.string().min(1, 'ID must not be empty'),
+    type: z.string().min(1, 'Type must not be empty'),
+    title: z.string().optional(),
+    author: z.array(cslNameSchema).optional(),
+    editor: z.array(cslNameSchema).optional(),
+    issued: cslDateSchema.optional(),
+    'container-title': z.string().optional(),
+    volume: z.string().optional(),
+    page: z.string().optional(),
+    publisher: z.string().optional(),
+    'publisher-place': z.string().optional(),
+    edition: z.string().optional(),
+    authority: z.string().optional(),
+    number: z.string().optional(),
+    genre: z.string().optional(),
+    url: z.string().optional(),
+    note: z.string().optional(),
+}).passthrough();
+/** Required fields per CSL type */
+const REQUIRED_FIELDS = {
+    'legal_case': ['title', 'authority', 'number', 'issued'],
+    'book': ['title', 'issued'],
+    'article-journal': ['title', 'container-title', 'issued'],
+    'chapter': ['title', 'container-title', 'issued'],
+    'legislation': ['title', 'issued'],
+    'thesis': ['title', 'issued'],
+};
+/** Validate required fields for a given CSL type */
+export function validateRequiredFields(entry) {
+    const issues = [];
+    const required = REQUIRED_FIELDS[entry.type];
+    if (!required)
+        return issues;
+    for (const field of required) {
+        const value = entry[field];
+        if (value === undefined || value === null || value === '') {
+            issues.push({
+                id: entry.id,
+                field,
+                message: `Missing required field '${field}' for type '${entry.type}'`,
+                severity: 'error',
+            });
+        }
+    }
+    return issues;
+}
+/** Validate an entire bibliography */
+export function validateBibliography(entries) {
+    const issues = [];
+    const seenIds = new Set();
+    for (const entry of entries) {
+        // Duplicate ID check
+        if (seenIds.has(entry.id)) {
+            issues.push({ id: entry.id, message: `Duplicate ID '${entry.id}'`, severity: 'error' });
+        }
+        seenIds.add(entry.id);
+        // Required fields
+        issues.push(...validateRequiredFields(entry));
+        // Missing issued warning
+        if (!entry.issued) {
+            issues.push({
+                id: entry.id,
+                field: 'issued',
+                message: `Missing 'issued' date`,
+                severity: 'warning',
+            });
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=schema.js.map

package/dist/providers/bib/schema.js.map

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

package/dist/providers/bib/store.d.ts

@@ -0,0 +1,17 @@
+import { CslEntry } from './schema.js';
+export declare class BibStore {
+    /** Read and parse a CSL-YAML file */
+    read(filePath: string): Promise<CslEntry[]>;
+    /** Write entries back to a CSL-YAML file, creating a .bak backup first */
+    write(filePath: string, entries: CslEntry[]): Promise<void>;
+    /** Get a single entry by ID */
+    get(filePath: string, id: string): Promise<CslEntry | undefined>;
+    /** Check if an ID exists */
+    exists(filePath: string, id: string): Promise<boolean>;
+    /** Add a new entry (appends to end) */
+    add(filePath: string, entry: CslEntry): Promise<void>;
+    /** Update fields of an existing entry */
+    update(filePath: string, id: string, fields: Record<string, unknown>): Promise<CslEntry>;
+    /** Delete an entry by ID */
+    delete(filePath: string, id: string): Promise<void>;
+}