@rustledger/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,79 @@
+# @rustledger/mcp-server
+
+MCP (Model Context Protocol) server for [rustledger](https://rustledger.github.io) - validate, query, and format Beancount ledgers directly from AI assistants.
+
+## Installation
+
+```bash
+npm install -g @rustledger/mcp-server
+```
+
+Or use directly with npx:
+
+```bash
+npx @rustledger/mcp-server
+```
+
+## Configuration
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "rustledger": {
+      "command": "npx",
+      "args": ["-y", "@rustledger/mcp-server"]
+    }
+  }
+}
+```
+
+### Claude Code
+
+Add to your Claude Code settings:
+
+```json
+{
+  "mcpServers": {
+    "rustledger": {
+      "command": "npx",
+      "args": ["-y", "@rustledger/mcp-server"]
+    }
+  }
+}
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `validate` | Validate a Beancount ledger for errors |
+| `query` | Run BQL queries on a ledger |
+| `balances` | Get account balances (shorthand for BALANCES query) |
+| `format` | Format a ledger with consistent alignment |
+| `parse` | Parse a ledger and return structured data |
+| `completions` | Get BQL query completions |
+| `list_plugins` | List available native plugins |
+| `run_plugin` | Run a native plugin on a ledger |
+
+## Example Usage
+
+Once configured, you can ask your AI assistant:
+
+- "Validate this beancount file for errors"
+- "What's my current balance in Assets:Checking?"
+- "Show me all restaurant expenses this month"
+- "Format this beancount ledger"
+
+## Resources
+
+The server also exposes documentation:
+
+- `rustledger://docs/bql` - BQL Query Language Reference
+
+## License
+
+GPL-3.0

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,475 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+// Import rustledger WASM bindings
+import * as rustledger from "@rustledger/wasm";
+// Initialize WASM module
+rustledger.init();
+const server = new Server({
+    name: "rustledger",
+    version: rustledger.version(),
+}, {
+    capabilities: {
+        tools: {},
+        resources: {},
+    },
+});
+// Tool definitions
+const TOOLS = [
+    {
+        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"],
+        },
+    },
+    {
+        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"],
+        },
+    },
+    {
+        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"],
+        },
+    },
+    {
+        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"],
+        },
+    },
+    {
+        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"],
+        },
+    },
+    {
+        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"],
+        },
+    },
+    {
+        name: "list_plugins",
+        description: "List available native plugins that can process ledgers.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        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"],
+        },
+    },
+];
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools: TOOLS };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "validate": {
+                const source = args?.source;
+                if (!source) {
+                    return {
+                        isError: true,
+                        content: [{ type: "text", text: "Missing required argument: source" }],
+                    };
+                }
+                const result = rustledger.validateSource(source);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: result.valid
+                                ? "Ledger is valid."
+                                : `Found ${result.errors.length} error(s):\n${formatErrors(result.errors)}`,
+                        },
+                    ],
+                };
+            }
+            case "query": {
+                const source = args?.source;
+                const query = args?.query;
+                if (!source || !query) {
+                    return {
+                        isError: true,
+                        content: [
+                            { type: "text", text: "Missing required arguments: source and query" },
+                        ],
+                    };
+                }
+                const result = rustledger.query(source, query);
+                if (result.errors?.length > 0) {
+                    return {
+                        isError: true,
+                        content: [{ type: "text", text: formatErrors(result.errors) }],
+                    };
+                }
+                return {
+                    content: [{ type: "text", text: formatQueryResult(result) }],
+                };
+            }
+            case "balances": {
+                const source = args?.source;
+                if (!source) {
+                    return {
+                        isError: true,
+                        content: [{ type: "text", text: "Missing required argument: source" }],
+                    };
+                }
+                const result = rustledger.balances(source);
+                if (result.errors?.length > 0) {
+                    return {
+                        isError: true,
+                        content: [{ type: "text", text: formatErrors(result.errors) }],
+                    };
+                }
+                return {
+                    content: [{ type: "text", text: formatQueryResult(result) }],
+                };
+            }
+            case "format": {
+                const source = args?.source;
+                if (!source) {
+                    return {
+                        isError: true,
+                        content: [{ type: "text", text: "Missing required argument: source" }],
+                    };
+                }
+                const result = rustledger.format(source);
+                if (result.errors?.length > 0) {
+                    return {
+                        isError: true,
+                        content: [{ type: "text", text: formatErrors(result.errors) }],
+                    };
+                }
+                return {
+                    content: [{ type: "text", text: result.formatted || "" }],
+                };
+            }
+            case "parse": {
+                const source = args?.source;
+                if (!source) {
+                    return {
+                        isError: true,
+                        content: [{ type: "text", text: "Missing required argument: source" }],
+                    };
+                }
+                const result = rustledger.parse(source);
+                if (result.errors?.length > 0) {
+                    return {
+                        isError: true,
+                        content: [{ type: "text", text: formatErrors(result.errors) }],
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result.ledger, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "completions": {
+                const partialQuery = args?.partial_query;
+                const cursorPos = args?.cursor_pos;
+                if (partialQuery === undefined || cursorPos === undefined) {
+                    return {
+                        isError: true,
+                        content: [
+                            {
+                                type: "text",
+                                text: "Missing required arguments: partial_query and cursor_pos",
+                            },
+                        ],
+                    };
+                }
+                const result = rustledger.bqlCompletions(partialQuery, cursorPos);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case "list_plugins": {
+                const plugins = rustledger.listPlugins();
+                return {
+                    content: [{ type: "text", text: JSON.stringify(plugins, null, 2) }],
+                };
+            }
+            case "run_plugin": {
+                const source = args?.source;
+                const pluginName = args?.plugin_name;
+                if (!source || !pluginName) {
+                    return {
+                        isError: true,
+                        content: [
+                            {
+                                type: "text",
+                                text: "Missing required arguments: source and plugin_name",
+                            },
+                        ],
+                    };
+                }
+                const result = rustledger.runPlugin(source, pluginName);
+                if (result.errors?.length > 0) {
+                    return {
+                        isError: true,
+                        content: [{ type: "text", text: formatErrors(result.errors) }],
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Plugin processed ${result.directives.length} directives.`,
+                        },
+                    ],
+                };
+            }
+            default:
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `Unknown tool: ${name}` }],
+                };
+        }
+    }
+    catch (error) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+        };
+    }
+});
+// Resources
+const RESOURCES = [
+    {
+        uri: "rustledger://docs/bql",
+        name: "BQL Query Language Reference",
+        description: "Documentation for Beancount Query Language",
+        mimeType: "text/markdown",
+    },
+];
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    return { resources: RESOURCES };
+});
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const { uri } = request.params;
+    if (uri === "rustledger://docs/bql") {
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: "text/markdown",
+                    text: BQL_DOCS,
+                },
+            ],
+        };
+    }
+    throw new Error(`Unknown resource: ${uri}`);
+});
+function formatErrors(errors) {
+    return errors
+        .map((e) => {
+        const loc = e.line ? `:${e.line}${e.column ? `:${e.column}` : ""}` : "";
+        return `[${e.severity}]${loc} ${e.message}`;
+    })
+        .join("\n");
+}
+function formatQueryResult(result) {
+    if (!result.columns || result.columns.length === 0) {
+        return "No results.";
+    }
+    const { columns, rows } = result;
+    // Calculate column widths
+    const widths = columns.map((col, i) => {
+        const maxRowWidth = Math.max(...rows.map((row) => formatCell(row[i]).length));
+        return Math.max(col.length, maxRowWidth);
+    });
+    // Format header
+    const header = columns.map((col, i) => col.padEnd(widths[i])).join(" | ");
+    const separator = widths.map((w) => "-".repeat(w)).join("-+-");
+    // Format rows
+    const formattedRows = rows.map((row) => row.map((cell, i) => formatCell(cell).padEnd(widths[i])).join(" | "));
+    return [header, separator, ...formattedRows].join("\n");
+}
+function formatCell(value) {
+    if (value === null || value === undefined) {
+        return "";
+    }
+    if (typeof value === "object") {
+        // Handle Amount type
+        if ("number" in value && "currency" in value) {
+            const amount = value;
+            return `${amount.number} ${amount.currency}`;
+        }
+        // Handle Inventory type
+        if ("positions" in value) {
+            const inv = value;
+            return inv.positions
+                .map((p) => `${p.units.number} ${p.units.currency}`)
+                .join(", ");
+        }
+        return JSON.stringify(value);
+    }
+    return String(value);
+}
+// BQL Documentation
+const BQL_DOCS = `# BQL - Beancount Query Language
+
+BQL is a SQL-like query language for querying Beancount ledgers.
+
+## Basic Syntax
+
+\`\`\`sql
+SELECT [DISTINCT] <target-spec>, ...
+[FROM <from-spec>]
+[WHERE <where-expression>]
+[GROUP BY <group-spec>, ...]
+[ORDER BY <order-spec>, ...]
+[LIMIT <limit>]
+\`\`\`
+
+## Common Queries
+
+### Account Balances
+\`\`\`sql
+BALANCES
+-- or equivalently:
+SELECT account, sum(position) GROUP BY account
+\`\`\`
+
+### Filter by Account
+\`\`\`sql
+SELECT date, narration, position
+WHERE account ~ "Expenses:Food"
+\`\`\`
+
+### Filter by Date Range
+\`\`\`sql
+SELECT date, account, position
+WHERE date >= 2024-01-01 AND date < 2024-02-01
+\`\`\`
+
+### Monthly Summary
+\`\`\`sql
+SELECT year(date), month(date), sum(position)
+WHERE account ~ "Expenses"
+GROUP BY year(date), month(date)
+ORDER BY year(date), month(date)
+\`\`\`
+
+### Journal Entries
+\`\`\`sql
+JOURNAL "Assets:Checking"
+\`\`\`
+
+## Available Functions
+
+- \`year(date)\`, \`month(date)\`, \`day(date)\` - Extract date parts
+- \`sum(position)\` - Sum positions
+- \`count()\` - Count entries
+- \`first(x)\`, \`last(x)\` - First/last values
+- \`min(x)\`, \`max(x)\` - Min/max values
+
+## Operators
+
+- \`~\` - Regex match (e.g., \`account ~ "Expenses:.*"\`)
+- \`=\`, \`!=\`, \`<\`, \`>\`, \`<=\`, \`>=\` - Comparisons
+- \`AND\`, \`OR\`, \`NOT\` - Boolean operators
+`;
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr to avoid interfering with MCP protocol on stdout
+    console.error(`rustledger MCP server v${rustledger.version()} started`);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(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,49 @@
+{
+  "name": "@rustledger/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for rustledger - validate, query, and format Beancount ledgers",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "rustledger-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "beancount",
+    "accounting",
+    "ledger",
+    "finance",
+    "rustledger"
+  ],
+  "author": "Rustledger Contributors",
+  "license": "GPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rustledger/rustledger"
+  },
+  "homepage": "https://rustledger.github.io",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@rustledger/wasm": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}