@rustledger/mcp-server 0.2.0 → 0.5.2

package/dist/prompts.js

@@ -0,0 +1,122 @@
+// Prompts for the MCP server
+export const PROMPTS = [
+    {
+        name: "analyze_ledger",
+        description: "Analyze a Beancount ledger for insights and potential issues",
+        arguments: [
+            {
+                name: "focus",
+                description: "What to focus on: spending, income, assets, or all",
+                required: false,
+            },
+        ],
+    },
+    {
+        name: "write_query",
+        description: "Help write a BQL query based on natural language description",
+        arguments: [
+            {
+                name: "description",
+                description: "What you want to query in plain English",
+                required: true,
+            },
+        ],
+    },
+    {
+        name: "categorize_transaction",
+        description: "Help categorize a transaction with appropriate accounts",
+        arguments: [
+            {
+                name: "description",
+                description: "Description of the transaction (payee, amount, context)",
+                required: true,
+            },
+        ],
+    },
+];
+export function getPrompt(name, args) {
+    switch (name) {
+        case "analyze_ledger": {
+            const focus = args?.focus || "all";
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: `Please analyze this Beancount ledger with a focus on ${focus}.
+
+Use the following tools to gather information:
+1. First use \`ledger_stats\` to get an overview
+2. Use \`list_accounts\` to understand the account structure
+3. Run appropriate BQL queries to analyze ${focus === "spending" ? "Expenses" : focus === "income" ? "Income" : focus === "assets" ? "Assets" : "all accounts"}
+4. Look for any validation errors
+
+Provide insights on:
+- Overall financial health
+- Spending patterns (if applicable)
+- Account organization
+- Any potential issues or improvements`,
+                        },
+                    },
+                ],
+            };
+        }
+        case "write_query": {
+            const description = args?.description;
+            if (!description) {
+                throw new Error("Missing required argument: description");
+            }
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: `Help me write a BQL (Beancount Query Language) query for the following:
+
+"${description}"
+
+Please:
+1. Write the BQL query
+2. Explain what each part does
+3. Provide any variations that might be useful
+
+Reference the BQL documentation if needed using the rustledger://docs/bql resource.`,
+                        },
+                    },
+                ],
+            };
+        }
+        case "categorize_transaction": {
+            const description = args?.description;
+            if (!description) {
+                throw new Error("Missing required argument: description");
+            }
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: `Help me categorize this transaction in Beancount format:
+
+"${description}"
+
+Please:
+1. Suggest appropriate account names following Beancount conventions
+2. Provide the full transaction entry
+3. Explain the categorization choice
+4. Suggest any relevant tags or links
+
+If you have access to an existing ledger, use \`list_accounts\` to match existing account naming conventions.`,
+                        },
+                    },
+                ],
+            };
+        }
+        default:
+            throw new Error(`Unknown prompt: ${name}`);
+    }
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,6BAA6B;AA2B7B,MAAM,CAAC,MAAM,OAAO,GAAuB;IACzC;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,8DAA8D;QAC3E,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,oDAAoD;gBACjE,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,8DAA8D;QAC3E,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,yCAAyC;gBACtD,QAAQ,EAAE,IAAI;aACf;SACF;KACF;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,yDAAyD;QACtE,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,yDAAyD;gBACtE,QAAQ,EAAE,IAAI;aACf;SACF;KACF;CACF,CAAC;AAEF,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,IAA6B;IAE7B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC;YACnC,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE;4BACP,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,wDAAwD,KAAK;;;;;4CAKrC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc;;;;;;;uCAOvH;yBAC1B;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAED,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,CAAC;YACtC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAC5D,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE;4BACP,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE;;GAEjB,WAAW;;;;;;;oFAOsE;yBACvE;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAED,KAAK,wBAAwB,CAAC,CAAC,CAAC;YAC9B,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,CAAC;YACtC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAC5D,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE;4BACP,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE;;GAEjB,WAAW;;;;;;;;8GAQgG;yBACjG;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/resources.d.ts

@@ -0,0 +1,19 @@
+export declare function getBqlDocs(): string;
+export declare function getBqlTablesDocs(): string;
+export declare function getValidationErrorsDocs(): string;
+export declare function getBqlFunctionsDocs(): string;
+export declare function getDirectivesDocs(): string;
+export interface ResourceDefinition {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}
+export declare const RESOURCES: ResourceDefinition[];
+export interface ResourceContents {
+    uri: string;
+    mimeType: string;
+    text: string;
+}
+export declare function getResourceContents(uri: string): ResourceContents | null;
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AA2BA,wBAAgB,UAAU,IAAI,MAAM,CAKnC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAKzC;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAKhD;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAK5C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,SAAS,EAAE,kBAAkB,EAyBzC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAaxE"}

package/dist/resources.js

@@ -0,0 +1,94 @@
+// Resources for the MCP server
+import * as fs from "fs";
+import * as path from "path";
+import { fileURLToPath } from "url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Load documentation from markdown files
+function loadDoc(filename) {
+    // When running from dist/, docs are in dist/docs/
+    const docPath = path.join(__dirname, "docs", filename);
+    try {
+        return fs.readFileSync(docPath, "utf-8");
+    }
+    catch {
+        return `Documentation not found: ${filename}`;
+    }
+}
+// Lazy-load documentation
+let _bqlDocs = null;
+let _bqlTablesDocs = null;
+let _validationErrorsDocs = null;
+let _bqlFunctionsDocs = null;
+let _directivesDocs = null;
+export function getBqlDocs() {
+    if (_bqlDocs === null) {
+        _bqlDocs = loadDoc("bql.md");
+    }
+    return _bqlDocs;
+}
+export function getBqlTablesDocs() {
+    if (_bqlTablesDocs === null) {
+        _bqlTablesDocs = loadDoc("bql-tables.md");
+    }
+    return _bqlTablesDocs;
+}
+export function getValidationErrorsDocs() {
+    if (_validationErrorsDocs === null) {
+        _validationErrorsDocs = loadDoc("validation-errors.md");
+    }
+    return _validationErrorsDocs;
+}
+export function getBqlFunctionsDocs() {
+    if (_bqlFunctionsDocs === null) {
+        _bqlFunctionsDocs = loadDoc("bql-functions.md");
+    }
+    return _bqlFunctionsDocs;
+}
+export function getDirectivesDocs() {
+    if (_directivesDocs === null) {
+        _directivesDocs = loadDoc("directives.md");
+    }
+    return _directivesDocs;
+}
+export const RESOURCES = [
+    {
+        uri: "rustledger://docs/bql",
+        name: "BQL Query Language Reference",
+        description: "Documentation for Beancount Query Language",
+        mimeType: "text/markdown",
+    },
+    {
+        uri: "rustledger://docs/validation-errors",
+        name: "Validation Error Reference",
+        description: "All 27 validation error codes with descriptions",
+        mimeType: "text/markdown",
+    },
+    {
+        uri: "rustledger://docs/bql-functions",
+        name: "BQL Functions Reference",
+        description: "Complete BQL function documentation",
+        mimeType: "text/markdown",
+    },
+    {
+        uri: "rustledger://docs/directives",
+        name: "Beancount Directives Reference",
+        description: "All Beancount directive types and their syntax",
+        mimeType: "text/markdown",
+    },
+];
+export function getResourceContents(uri) {
+    switch (uri) {
+        case "rustledger://docs/bql":
+            return { uri, mimeType: "text/markdown", text: getBqlDocs() };
+        case "rustledger://docs/validation-errors":
+            return { uri, mimeType: "text/markdown", text: getValidationErrorsDocs() };
+        case "rustledger://docs/bql-functions":
+            return { uri, mimeType: "text/markdown", text: getBqlFunctionsDocs() };
+        case "rustledger://docs/directives":
+            return { uri, mimeType: "text/markdown", text: getDirectivesDocs() };
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,yCAAyC;AACzC,SAAS,OAAO,CAAC,QAAgB;IAC/B,kDAAkD;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvD,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,4BAA4B,QAAQ,EAAE,CAAC;IAChD,CAAC;AACH,CAAC;AAED,0BAA0B;AAC1B,IAAI,QAAQ,GAAkB,IAAI,CAAC;AACnC,IAAI,cAAc,GAAkB,IAAI,CAAC;AACzC,IAAI,qBAAqB,GAAkB,IAAI,CAAC;AAChD,IAAI,iBAAiB,GAAkB,IAAI,CAAC;AAC5C,IAAI,eAAe,GAAkB,IAAI,CAAC;AAE1C,MAAM,UAAU,UAAU;IACxB,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;QAC5B,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,IAAI,qBAAqB,KAAK,IAAI,EAAE,CAAC;QACnC,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;QAC/B,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;QAC7B,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AASD,MAAM,CAAC,MAAM,SAAS,GAAyB;IAC7C;QACE,GAAG,EAAE,uBAAuB;QAC5B,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,4CAA4C;QACzD,QAAQ,EAAE,eAAe;KAC1B;IACD;QACE,GAAG,EAAE,qCAAqC;QAC1C,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE,iDAAiD;QAC9D,QAAQ,EAAE,eAAe;KAC1B;IACD;QACE,GAAG,EAAE,iCAAiC;QACtC,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,qCAAqC;QAClD,QAAQ,EAAE,eAAe;KAC1B;IACD;QACE,GAAG,EAAE,8BAA8B;QACnC,IAAI,EAAE,gCAAgC;QACtC,WAAW,EAAE,gDAAgD;QAC7D,QAAQ,EAAE,eAAe;KAC1B;CACF,CAAC;AAQF,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,uBAAuB;YAC1B,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC;QAChE,KAAK,qCAAqC;YACxC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,uBAAuB,EAAE,EAAE,CAAC;QAC7E,KAAK,iCAAiC;YACpC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,CAAC;QACzE,KAAK,8BAA8B;YACjC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,iBAAiB,EAAE,EAAE,CAAC;QACvE;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,36 @@
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required: string[];
+    };
+}
+export declare const validateTool: ToolDefinition;
+export declare const queryTool: ToolDefinition;
+export declare const balancesTool: ToolDefinition;
+export declare const formatTool: ToolDefinition;
+export declare const parseTool: ToolDefinition;
+export declare const completionsTool: ToolDefinition;
+export declare const listPluginsTool: ToolDefinition;
+export declare const runPluginTool: ToolDefinition;
+export declare const editorCompletionsTool: ToolDefinition;
+export declare const editorHoverTool: ToolDefinition;
+export declare const editorDefinitionTool: ToolDefinition;
+export declare const editorDocumentSymbolsTool: ToolDefinition;
+export declare const editorReferencesTool: ToolDefinition;
+export declare const ledgerStatsTool: ToolDefinition;
+export declare const listAccountsTool: ToolDefinition;
+export declare const listCommoditiesTool: ToolDefinition;
+export declare const accountActivityTool: ToolDefinition;
+export declare const formatCheckTool: ToolDefinition;
+export declare const bqlTablesTool: ToolDefinition;
+export declare const directiveAtLineTool: ToolDefinition;
+export declare const findTransactionsTool: ToolDefinition;
+export declare const reportTool: ToolDefinition;
+export declare const validateFileTool: ToolDefinition;
+export declare const queryFileTool: ToolDefinition;
+export declare const formatFileTool: ToolDefinition;
+export declare const TOOLS: ToolDefinition[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAID,eAAO,MAAM,YAAY,EAAE,cAc1B,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,cAmBvB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,cAc1B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,cAcxB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,cAcvB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAkB7B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAQ7B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,cAkB3B,CAAC;AAIF,eAAO,MAAM,qBAAqB,EAAE,cAsBnC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAsB7B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,cAsBlC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,cAcvC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,cAsBlC,CAAC;AAIF,eAAO,MAAM,eAAe,EAAE,cAc7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,cAc9B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,cAajC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,cAkBjC,CAAC;AAIF,eAAO,MAAM,eAAe,EAAE,cAc7B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,cAS3B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,cAiBjC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,cAsClC,CAAC;AAIF,eAAO,MAAM,UAAU,EAAE,cAuBxB,CAAC;AAIF,eAAO,MAAM,gBAAgB,EAAE,cAc9B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,cAiB3B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cAkB5B,CAAC;AAGF,eAAO,MAAM,KAAK,EAAE,cAAc,EAgCjC,CAAC"}