@rustledger/mcp-server 0.2.0 → 0.5.2

package/dist/tools.js

@@ -0,0 +1,475 @@
+// Tool definitions for the MCP server
+// === Original Tools ===
+export const validateTool = {
+    name: "validate",
+    description: "Validate a Beancount ledger. Returns validation errors and warnings if any issues are found.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text to validate",
+            },
+        },
+        required: ["source"],
+    },
+};
+export const queryTool = {
+    name: "query",
+    description: "Run a BQL (Beancount Query Language) query on a ledger. Use this for account balances, filtering transactions, aggregations, etc.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text",
+            },
+            query: {
+                type: "string",
+                description: 'The BQL query to execute (e.g., "SELECT account, sum(position) GROUP BY account")',
+            },
+        },
+        required: ["source", "query"],
+    },
+};
+export const balancesTool = {
+    name: "balances",
+    description: "Get account balances from a ledger. This is a shorthand for running a BALANCES query.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text",
+            },
+        },
+        required: ["source"],
+    },
+};
+export const formatTool = {
+    name: "format",
+    description: "Format a Beancount ledger with consistent alignment and spacing.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text to format",
+            },
+        },
+        required: ["source"],
+    },
+};
+export const parseTool = {
+    name: "parse",
+    description: "Parse a Beancount ledger and return the directives as structured data.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text to parse",
+            },
+        },
+        required: ["source"],
+    },
+};
+export const completionsTool = {
+    name: "completions",
+    description: "Get BQL query completions at a cursor position. Useful for building query editors.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            partial_query: {
+                type: "string",
+                description: "The partial BQL query text",
+            },
+            cursor_pos: {
+                type: "number",
+                description: "The cursor position (character offset) in the query",
+            },
+        },
+        required: ["partial_query", "cursor_pos"],
+    },
+};
+export const listPluginsTool = {
+    name: "list_plugins",
+    description: "List available native plugins that can process ledgers.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        required: [],
+    },
+};
+export const runPluginTool = {
+    name: "run_plugin",
+    description: "Run a native plugin on a ledger.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text",
+            },
+            plugin_name: {
+                type: "string",
+                description: "The name of the plugin to run (use list_plugins to see available plugins)",
+            },
+        },
+        required: ["source", "plugin_name"],
+    },
+};
+// === Editor Tools (LSP-like) ===
+export const editorCompletionsTool = {
+    name: "editor_completions",
+    description: "Get context-aware completions for Beancount source at a given position. Returns account names, currencies, directives, etc.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text",
+            },
+            line: {
+                type: "number",
+                description: "Line number (0-indexed)",
+            },
+            character: {
+                type: "number",
+                description: "Character position in the line (0-indexed)",
+            },
+        },
+        required: ["source", "line", "character"],
+    },
+};
+export const editorHoverTool = {
+    name: "editor_hover",
+    description: "Get hover information for a symbol at the given position. Returns documentation for accounts, currencies, and directives.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text",
+            },
+            line: {
+                type: "number",
+                description: "Line number (0-indexed)",
+            },
+            character: {
+                type: "number",
+                description: "Character position in the line (0-indexed)",
+            },
+        },
+        required: ["source", "line", "character"],
+    },
+};
+export const editorDefinitionTool = {
+    name: "editor_definition",
+    description: "Get the definition location for a symbol (account or currency). Returns the location of the Open or Commodity directive.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text",
+            },
+            line: {
+                type: "number",
+                description: "Line number (0-indexed)",
+            },
+            character: {
+                type: "number",
+                description: "Character position in the line (0-indexed)",
+            },
+        },
+        required: ["source", "line", "character"],
+    },
+};
+export const editorDocumentSymbolsTool = {
+    name: "editor_document_symbols",
+    description: "Get all symbols in the document for an outline/structure view. Returns all directives with their positions.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text",
+            },
+        },
+        required: ["source"],
+    },
+};
+export const editorReferencesTool = {
+    name: "editor_references",
+    description: "Find all references to a symbol (account, currency, or payee) at the given position. Returns all locations where the symbol is used.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text",
+            },
+            line: {
+                type: "number",
+                description: "Line number (0-indexed)",
+            },
+            character: {
+                type: "number",
+                description: "Character position in the line (0-indexed)",
+            },
+        },
+        required: ["source", "line", "character"],
+    },
+};
+// === Analysis Tools ===
+export const ledgerStatsTool = {
+    name: "ledger_stats",
+    description: "Get statistics about a ledger: counts of directives, accounts, currencies, date range, etc.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text",
+            },
+        },
+        required: ["source"],
+    },
+};
+export const listAccountsTool = {
+    name: "list_accounts",
+    description: "List all accounts in the ledger with their open/close dates and currencies.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text",
+            },
+        },
+        required: ["source"],
+    },
+};
+export const listCommoditiesTool = {
+    name: "list_commodities",
+    description: "List all currencies/commodities used in the ledger.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text",
+            },
+        },
+        required: ["source"],
+    },
+};
+export const accountActivityTool = {
+    name: "account_activity",
+    description: "Get activity summary for a specific account: first/last transaction, total transactions, currencies used.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text",
+            },
+            account: {
+                type: "string",
+                description: "The account name to analyze (e.g., 'Assets:Checking')",
+            },
+        },
+        required: ["source", "account"],
+    },
+};
+// === Utility Tools ===
+export const formatCheckTool = {
+    name: "format_check",
+    description: "Check if a ledger is properly formatted. Returns differences if formatting would change the file.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text",
+            },
+        },
+        required: ["source"],
+    },
+};
+export const bqlTablesTool = {
+    name: "bql_tables",
+    description: "Get documentation for BQL tables (entries, postings, etc.) and their available columns.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        required: [],
+    },
+};
+export const directiveAtLineTool = {
+    name: "directive_at_line",
+    description: "Get the directive at a specific line number in the source.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text",
+            },
+            line: {
+                type: "number",
+                description: "Line number (1-indexed)",
+            },
+        },
+        required: ["source", "line"],
+    },
+};
+export const findTransactionsTool = {
+    name: "find_transactions",
+    description: "Find transactions matching criteria: payee, narration, tags, or date range.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text",
+            },
+            payee: {
+                type: "string",
+                description: "Filter by payee (substring match)",
+            },
+            narration: {
+                type: "string",
+                description: "Filter by narration (substring match)",
+            },
+            tag: {
+                type: "string",
+                description: "Filter by tag",
+            },
+            from_date: {
+                type: "string",
+                description: "Filter by start date (YYYY-MM-DD)",
+            },
+            to_date: {
+                type: "string",
+                description: "Filter by end date (YYYY-MM-DD)",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum number of results (default: 50)",
+            },
+        },
+        required: ["source"],
+    },
+};
+// === Report Tool ===
+export const reportTool = {
+    name: "report",
+    description: "Generate financial reports: balance sheet, income statement, holdings, or net worth.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: {
+                type: "string",
+                description: "The Beancount ledger source text",
+            },
+            report_type: {
+                type: "string",
+                enum: ["balsheet", "income", "balances", "holdings", "networth"],
+                description: "Type of report to generate",
+            },
+            currency: {
+                type: "string",
+                description: "Convert all amounts to this currency (optional)",
+            },
+        },
+        required: ["source", "report_type"],
+    },
+};
+// === File Operation Tools ===
+export const validateFileTool = {
+    name: "validate_file",
+    description: "Validate a Beancount file from the filesystem. Handles includes automatically.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            file_path: {
+                type: "string",
+                description: "Path to the Beancount file to validate",
+            },
+        },
+        required: ["file_path"],
+    },
+};
+export const queryFileTool = {
+    name: "query_file",
+    description: "Run a BQL query on a Beancount file from the filesystem.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            file_path: {
+                type: "string",
+                description: "Path to the Beancount file",
+            },
+            query: {
+                type: "string",
+                description: "The BQL query to execute",
+            },
+        },
+        required: ["file_path", "query"],
+    },
+};
+export const formatFileTool = {
+    name: "format_file",
+    description: "Format a Beancount file. Can optionally write the formatted output back to the file.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            file_path: {
+                type: "string",
+                description: "Path to the Beancount file to format",
+            },
+            write: {
+                type: "boolean",
+                description: "If true, write the formatted output back to the file",
+            },
+        },
+        required: ["file_path"],
+    },
+};
+// All tools combined
+export const TOOLS = [
+    // Original Tools
+    validateTool,
+    queryTool,
+    balancesTool,
+    formatTool,
+    parseTool,
+    completionsTool,
+    listPluginsTool,
+    runPluginTool,
+    // Editor Tools
+    editorCompletionsTool,
+    editorHoverTool,
+    editorDefinitionTool,
+    editorDocumentSymbolsTool,
+    editorReferencesTool,
+    // Analysis Tools
+    ledgerStatsTool,
+    listAccountsTool,
+    listCommoditiesTool,
+    accountActivityTool,
+    // Utility Tools
+    formatCheckTool,
+    bqlTablesTool,
+    directiveAtLineTool,
+    findTransactionsTool,
+    // Report Tool
+    reportTool,
+    // File Operation Tools
+    validateFileTool,
+    queryFileTool,
+    formatFileTool,
+];
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,140 @@
+export interface Amount {
+    number: string;
+    currency: string;
+}
+export interface Posting {
+    account: string;
+    units?: Amount;
+}
+export interface BaseDirective {
+    type: string;
+    date: string;
+}
+export interface TransactionDirective extends BaseDirective {
+    type: "transaction";
+    flag: string;
+    payee?: string;
+    narration?: string;
+    tags?: string[];
+    links?: string[];
+    postings: Posting[];
+}
+export interface OpenDirective extends BaseDirective {
+    type: "open";
+    account: string;
+    currencies?: string[];
+    booking?: string;
+}
+export interface CloseDirective extends BaseDirective {
+    type: "close";
+    account: string;
+}
+export interface BalanceDirective extends BaseDirective {
+    type: "balance";
+    account: string;
+    amount: Amount;
+}
+export interface CommodityDirective extends BaseDirective {
+    type: "commodity";
+    currency: string;
+}
+export interface PriceDirective extends BaseDirective {
+    type: "price";
+    currency: string;
+    amount: Amount;
+}
+export interface EventDirective extends BaseDirective {
+    type: "event";
+    event_type: string;
+    value: string;
+}
+export interface NoteDirective extends BaseDirective {
+    type: "note";
+    account: string;
+    comment: string;
+}
+export interface DocumentDirective extends BaseDirective {
+    type: "document";
+    account: string;
+    path: string;
+}
+export interface PadDirective extends BaseDirective {
+    type: "pad";
+    account: string;
+    source_account: string;
+}
+export interface QueryDirective extends BaseDirective {
+    type: "query";
+    name: string;
+    query_string: string;
+}
+export interface CustomDirective extends BaseDirective {
+    type: "custom";
+    custom_type: string;
+}
+export type Directive = TransactionDirective | OpenDirective | CloseDirective | BalanceDirective | CommodityDirective | PriceDirective | EventDirective | NoteDirective | DocumentDirective | PadDirective | QueryDirective | CustomDirective;
+export interface DocumentSymbol {
+    name: string;
+    kind: string;
+    detail?: string;
+    range: {
+        start_line: number;
+        end_line: number;
+        start_character: number;
+        end_character: number;
+    };
+}
+export interface BeancountError {
+    message: string;
+    line?: number;
+    column?: number;
+    severity: "error" | "warning";
+}
+export interface QueryResult {
+    columns: string[];
+    rows: unknown[][];
+    errors?: BeancountError[];
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: BeancountError[];
+}
+export interface FormatResult {
+    formatted?: string;
+    errors?: BeancountError[];
+}
+export interface ParseResult {
+    ledger?: {
+        directives: Directive[];
+    };
+    errors?: BeancountError[];
+}
+export interface ToolResponse {
+    isError?: boolean;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    [key: string]: unknown;
+}
+export interface ToolArguments {
+    source?: string;
+    query?: string;
+    partial_query?: string;
+    cursor_pos?: number;
+    plugin_name?: string;
+    line?: number;
+    character?: number;
+    account?: string;
+    payee?: string;
+    narration?: string;
+    tag?: string;
+    from_date?: string;
+    to_date?: string;
+    limit?: number;
+    report_type?: string;
+    currency?: string;
+    file_path?: string;
+    write?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+// Type definitions for the MCP server
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,sCAAsC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rustledger/mcp-server",
-  "version": "0.2.0",
+  "version": "0.5.2",
   "description": "MCP server for rustledger - validate, query, and format Beancount ledgers",
   "type": "module",
   "main": "dist/index.js",
@@ -8,9 +8,11 @@
     "rustledger-mcp": "dist/index.js"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && cp -r src/docs dist/",
     "dev": "tsc --watch",
     "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -30,11 +32,12 @@
   "homepage": "https://rustledger.github.io",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "@rustledger/wasm": "^0.2.0"
+    "@rustledger/wasm": "^0.5.2"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "typescript": "^5.7.0"
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.17"
   },
   "engines": {
     "node": ">=18"