currency-exchange-mcp 1.0.0

package/README.md

@@ -0,0 +1,68 @@
+# Currency Exchange MCP
+
+A Model Context Protocol (MCP) server that provides currency exchange rate conversion tools.
+
+## Features
+
+- Convert amounts between currencies using real-time exchange rates
+- Get exchange rates between any two currencies
+- Support for historical exchange rates by date
+- Uses the reliable fawazahmed0/currency-api for exchange rate data
+
+## Installation
+
+```bash
+pnpm install
+pnpm run build
+```
+
+
+## Available Tools
+
+#### 1. `convert_currency`
+
+Converts an amount from one currency to another using current or historical exchange rates.
+
+**Example prompts:**
+- *"How much is 10 NOK in USD?"*
+- *"Convert 20000 yen to USD"*
+- *"How much was 100 USD worth in EUR on 2024-03-15?"*
+- *"Convert 500 CAD to JPY"*
+
+#### 2. `get_exchange_rate`
+
+Gets the exchange rate between two currencies.
+
+**Example prompts:**
+- *"What's the current exchange rate from EUR to GBP?"*
+- *"What's the USD to CHF rate?"*
+- *"What was the EUR to USD rate on 2024-01-01?"*
+
+### Using with Claude
+
+To use this MCP server with Claude, add it to your MCP configuration:
+
+```json
+{
+    "mcpServers": {
+        "currency-exchange": {
+            "command": "node",
+            "args": ["/path/to/currency-exchange-mcp/build/index.js"]
+        }
+    }
+}
+```
+
+Once configured, Claude will automatically use the appropriate tools when you ask currency-related questions.
+
+## Data Source
+
+This MCP server uses the [fawazahmed0/currency-api](https://github.com/fawazahmed0/exchange-api) which provides:
+- Real-time exchange rates
+- Historical exchange rates
+- Support for 150+ currencies
+- Free usage with no API key required
+
+## License
+
+MIT

package/build/currency-api.d.ts

@@ -0,0 +1,7 @@
+export declare class CurrencyApiClient {
+    private readonly baseUrl;
+    getExchangeRate(fromCurrency: string, toCurrency: string, date?: string): Promise<number>;
+    convertCurrency(amount: number, fromCurrency: string, toCurrency: string, date?: string): Promise<number>;
+    getSupportedCurrencies(baseCurrency?: string): Promise<string[]>;
+}
+//# sourceMappingURL=currency-api.d.ts.map

package/build/currency-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency-api.d.ts","sourceRoot":"","sources":["../src/currency-api.ts"],"names":[],"mappings":"AAEA,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4D;IAE9E,eAAe,CACjB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;IAiCZ,eAAe,CACjB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;IAKZ,sBAAsB,CAAC,YAAY,GAAE,MAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAoBhF"}

package/build/currency-api.js

@@ -0,0 +1,55 @@
+export class CurrencyApiClient {
+    baseUrl = 'https://cdn.jsdelivr.net/npm/@fawazahmed0/currency-api';
+    async getExchangeRate(fromCurrency, toCurrency, date) {
+        const normalizedFrom = fromCurrency.toLowerCase();
+        const normalizedTo = toCurrency.toLowerCase();
+        let url;
+        if (date) {
+            url = `${this.baseUrl}@${date}/v1/currencies/${normalizedFrom}.json`;
+        }
+        else {
+            url = `${this.baseUrl}@latest/v1/currencies/${normalizedFrom}.json`;
+        }
+        try {
+            const response = await fetch(url);
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+            const data = await response.json();
+            const rates = data[normalizedFrom];
+            if (!rates || !(normalizedTo in rates)) {
+                throw new Error(`Exchange rate not available for ${fromCurrency} to ${toCurrency}`);
+            }
+            return rates[normalizedTo];
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to fetch exchange rate: ${error.message}`);
+            }
+            throw new Error('Unknown error occurred while fetching exchange rate');
+        }
+    }
+    async convertCurrency(amount, fromCurrency, toCurrency, date) {
+        const rate = await this.getExchangeRate(fromCurrency, toCurrency, date);
+        return amount * rate;
+    }
+    async getSupportedCurrencies(baseCurrency = 'eur') {
+        const url = `${this.baseUrl}@latest/v1/currencies/${baseCurrency.toLowerCase()}.json`;
+        try {
+            const response = await fetch(url);
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+            const data = await response.json();
+            const rates = data[baseCurrency.toLowerCase()];
+            return Object.keys(rates).map(code => code.toUpperCase());
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to fetch supported currencies: ${error.message}`);
+            }
+            throw new Error('Unknown error occurred while fetching supported currencies');
+        }
+    }
+}
+//# sourceMappingURL=currency-api.js.map

package/build/currency-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency-api.js","sourceRoot":"","sources":["../src/currency-api.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,iBAAiB;IACT,OAAO,GAAG,wDAAwD,CAAC;IAEpF,KAAK,CAAC,eAAe,CACjB,YAAoB,EACpB,UAAkB,EAClB,IAAa;QAEb,MAAM,cAAc,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;QAClD,MAAM,YAAY,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QAE9C,IAAI,GAAW,CAAC;QAChB,IAAI,IAAI,EAAE,CAAC;YACP,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,kBAAkB,cAAc,OAAO,CAAC;QACzE,CAAC;aAAM,CAAC;YACJ,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,yBAAyB,cAAc,OAAO,CAAC;QACxE,CAAC;QAED,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9D,CAAC;YAED,MAAM,IAAI,GAAwB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxD,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;YAEnC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,YAAY,IAAI,KAAK,CAAC,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CAAC,mCAAmC,YAAY,OAAO,UAAU,EAAE,CAAC,CAAC;YACxF,CAAC;YAED,OAAO,KAAK,CAAC,YAAY,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACvE,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QAC3E,CAAC;IACL,CAAC;IAED,KAAK,CAAC,eAAe,CACjB,MAAc,EACd,YAAoB,EACpB,UAAkB,EAClB,IAAa;QAEb,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;QACxE,OAAO,MAAM,GAAG,IAAI,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,sBAAsB,CAAC,eAAuB,KAAK;QACrD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,yBAAyB,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC;QAEtF,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9D,CAAC;YAED,MAAM,IAAI,GAAwB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxD,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;YAE/C,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,yCAAyC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9E,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAClF,CAAC;IACL,CAAC;CACJ"}

package/build/index.d.ts

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

package/build/index.d.ts.map

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

package/build/index.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerCurrencyExchangeTools } from './tools/exchange.js';
+const server = new McpServer({
+    name: 'currency-exchange-mcp',
+    version: '1.0.0',
+});
+registerCurrencyExchangeTools(server);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('Currency Exchange MCP server running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAEpE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IACzB,IAAI,EAAE,uBAAuB;IAC7B,OAAO,EAAE,OAAO;CACnB,CAAC,CAAC;AAEH,6BAA6B,CAAC,MAAM,CAAC,CAAC;AAEtC,KAAK,UAAU,IAAI;IACf,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;AACnE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/build/programs/exchange.d.ts

@@ -0,0 +1,24 @@
+interface ExchangeOptions {
+    fromCurrency: string;
+    toCurrency: string;
+    amount?: number;
+    date?: string;
+}
+interface ExchangeRateResult {
+    rate: number;
+    fromCurrency: string;
+    toCurrency: string;
+    date: string;
+}
+interface ConversionResult extends ExchangeRateResult {
+    amount: number;
+    convertedAmount: number;
+}
+export declare class Exchange {
+    private static readonly baseUrl;
+    static getExchangeRate(options: ExchangeOptions): Promise<ExchangeRateResult>;
+    static convertCurrency(options: ExchangeOptions): Promise<ConversionResult>;
+    static getSupportedCurrencies(baseCurrency?: string): Promise<string[]>;
+}
+export {};
+//# sourceMappingURL=exchange.d.ts.map

package/build/programs/exchange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange.d.ts","sourceRoot":"","sources":["../../src/programs/exchange.ts"],"names":[],"mappings":"AAAA,UAAU,eAAe;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,kBAAkB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,gBAAiB,SAAQ,kBAAkB;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,QAAQ;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAA4D;WAE9E,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;WAuCtE,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;WAiBpE,sBAAsB,CAAC,YAAY,GAAE,MAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAoBvF"}

package/build/programs/exchange.js

@@ -0,0 +1,70 @@
+export class Exchange {
+    static baseUrl = 'https://cdn.jsdelivr.net/npm/@fawazahmed0/currency-api';
+    static async getExchangeRate(options) {
+        const { fromCurrency, toCurrency, date } = options;
+        const normalizedFrom = fromCurrency.toLowerCase();
+        const normalizedTo = toCurrency.toLowerCase();
+        let url;
+        if (date) {
+            url = `${this.baseUrl}@${date}/v1/currencies/${normalizedFrom}.json`;
+        }
+        else {
+            url = `${this.baseUrl}@latest/v1/currencies/${normalizedFrom}.json`;
+        }
+        try {
+            const response = await fetch(url);
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+            const data = await response.json();
+            const rates = data[normalizedFrom];
+            if (!rates || !(normalizedTo in rates)) {
+                throw new Error(`Exchange rate not available for ${fromCurrency} to ${toCurrency}`);
+            }
+            return {
+                rate: rates[normalizedTo],
+                fromCurrency: fromCurrency.toUpperCase(),
+                toCurrency: toCurrency.toUpperCase(),
+                date: date || new Date().toISOString().split('T')[0]
+            };
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to fetch exchange rate: ${error.message}`);
+            }
+            throw new Error('Unknown error occurred while fetching exchange rate');
+        }
+    }
+    static async convertCurrency(options) {
+        const { amount } = options;
+        if (!amount || amount <= 0) {
+            throw new Error('Amount must be provided and positive for currency conversion');
+        }
+        const rateResult = await this.getExchangeRate(options);
+        const convertedAmount = amount * rateResult.rate;
+        return {
+            ...rateResult,
+            amount,
+            convertedAmount: Math.round(convertedAmount * 100) / 100
+        };
+    }
+    static async getSupportedCurrencies(baseCurrency = 'eur') {
+        const url = `${this.baseUrl}@latest/v1/currencies/${baseCurrency.toLowerCase()}.json`;
+        try {
+            const response = await fetch(url);
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+            const data = await response.json();
+            const rates = data[baseCurrency.toLowerCase()];
+            return Object.keys(rates).map(code => code.toUpperCase()).sort();
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to fetch supported currencies: ${error.message}`);
+            }
+            throw new Error('Unknown error occurred while fetching supported currencies');
+        }
+    }
+}
+//# sourceMappingURL=exchange.js.map

package/build/programs/exchange.js.map

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

package/build/programs/index.d.ts

@@ -0,0 +1,2 @@
+export { Exchange } from './exchange.js';
+//# sourceMappingURL=index.d.ts.map

package/build/programs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/programs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/build/programs/index.js

@@ -0,0 +1,2 @@
+export { Exchange } from './exchange.js';
+//# sourceMappingURL=index.js.map

package/build/programs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/programs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/build/programs/types.d.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+export declare const CurrencyCodeSchema: z.ZodString;
+export declare const ConvertCurrencyArgsSchema: z.ZodObject<{
+    amount: z.ZodNumber;
+    from_currency: z.ZodString;
+    to_currency: z.ZodString;
+    date: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    amount: number;
+    from_currency: string;
+    to_currency: string;
+    date?: string | undefined;
+}, {
+    amount: number;
+    from_currency: string;
+    to_currency: string;
+    date?: string | undefined;
+}>;
+export declare const GetExchangeRateArgsSchema: z.ZodObject<{
+    from_currency: z.ZodString;
+    to_currency: z.ZodString;
+    date: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    from_currency: string;
+    to_currency: string;
+    date?: string | undefined;
+}, {
+    from_currency: string;
+    to_currency: string;
+    date?: string | undefined;
+}>;
+export type ConvertCurrencyArgs = z.infer<typeof ConvertCurrencyArgsSchema>;
+export type GetExchangeRateArgs = z.infer<typeof GetExchangeRateArgsSchema>;
+export interface CurrencyApiResponse {
+    [key: string]: {
+        [currencyCode: string]: number;
+    };
+}
+export interface ExchangeRateResult {
+    rate: number;
+    from_currency: string;
+    to_currency: string;
+    date: string;
+}
+export interface ConversionResult extends ExchangeRateResult {
+    amount: number;
+    converted_amount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/programs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/programs/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB,aAA2C,CAAC;AAE3E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;EAKpC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAIpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG;QACX,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;KAClC,CAAC;CACL;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;CAC5B"}

package/build/programs/types.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export const CurrencyCodeSchema = z.string().length(3).regex(/^[A-Z]{3}$/);
+export const ConvertCurrencyArgsSchema = z.object({
+    amount: z.number().positive(),
+    from_currency: CurrencyCodeSchema,
+    to_currency: CurrencyCodeSchema,
+    date: z.string().optional().describe('Date in YYYY-MM-DD format. If not provided, uses latest rates')
+});
+export const GetExchangeRateArgsSchema = z.object({
+    from_currency: CurrencyCodeSchema,
+    to_currency: CurrencyCodeSchema,
+    date: z.string().optional().describe('Date in YYYY-MM-DD format. If not provided, uses latest rates')
+});
+//# sourceMappingURL=types.js.map

package/build/programs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/programs/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AAE3E,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,aAAa,EAAE,kBAAkB;IACjC,WAAW,EAAE,kBAAkB;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;CACxG,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,aAAa,EAAE,kBAAkB;IACjC,WAAW,EAAE,kBAAkB;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;CACxG,CAAC,CAAC"}

package/build/tools/currency-exchange-tool.d.ts

@@ -0,0 +1,10 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ConversionResult, ExchangeRateResult } from '../types.js';
+export declare class CurrencyExchangeTool {
+    private apiClient;
+    constructor();
+    getToolDefinitions(): Tool[];
+    convertCurrency(args: unknown): Promise<ConversionResult>;
+    getExchangeRate(args: unknown): Promise<ExchangeRateResult>;
+}
+//# sourceMappingURL=currency-exchange-tool.d.ts.map

package/build/tools/currency-exchange-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency-exchange-tool.d.ts","sourceRoot":"","sources":["../../src/tools/currency-exchange-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,EAKH,gBAAgB,EAChB,kBAAkB,EACrB,MAAM,aAAa,CAAC;AAErB,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,SAAS,CAAoB;;IAMrC,kBAAkB,IAAI,IAAI,EAAE;IA4DtB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqBzD,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAiBpE"}

package/build/tools/currency-exchange-tool.js

@@ -0,0 +1,103 @@
+import { CurrencyApiClient } from '../currency-api.js';
+import { ConvertCurrencyArgsSchema, GetExchangeRateArgsSchema } from '../types.js';
+export class CurrencyExchangeTool {
+    apiClient;
+    constructor() {
+        this.apiClient = new CurrencyApiClient();
+    }
+    getToolDefinitions() {
+        return [
+            {
+                name: 'convert_currency',
+                description: 'Convert an amount from one currency to another using current or historical exchange rates',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        amount: {
+                            type: 'number',
+                            description: 'The amount to convert (must be positive)',
+                            minimum: 0
+                        },
+                        from_currency: {
+                            type: 'string',
+                            description: 'Source currency code (3 letters, e.g., USD, EUR, NOK)',
+                            pattern: '^[A-Z]{3}$'
+                        },
+                        to_currency: {
+                            type: 'string',
+                            description: 'Target currency code (3 letters, e.g., USD, EUR, NOK)',
+                            pattern: '^[A-Z]{3}$'
+                        },
+                        date: {
+                            type: 'string',
+                            description: 'Optional date in YYYY-MM-DD format for historical rates. If not provided, uses latest rates',
+                            pattern: '^\\d{4}-\\d{2}-\\d{2}$'
+                        }
+                    },
+                    required: ['amount', 'from_currency', 'to_currency']
+                }
+            },
+            {
+                name: 'get_exchange_rate',
+                description: 'Get the exchange rate between two currencies',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        from_currency: {
+                            type: 'string',
+                            description: 'Source currency code (3 letters, e.g., USD, EUR, NOK)',
+                            pattern: '^[A-Z]{3}$'
+                        },
+                        to_currency: {
+                            type: 'string',
+                            description: 'Target currency code (3 letters, e.g., USD, EUR, NOK)',
+                            pattern: '^[A-Z]{3}$'
+                        },
+                        date: {
+                            type: 'string',
+                            description: 'Optional date in YYYY-MM-DD format for historical rates. If not provided, uses latest rates',
+                            pattern: '^\\d{4}-\\d{2}-\\d{2}$'
+                        }
+                    },
+                    required: ['from_currency', 'to_currency']
+                }
+            }
+        ];
+    }
+    async convertCurrency(args) {
+        const validatedArgs = ConvertCurrencyArgsSchema.parse(args);
+        const { amount, from_currency, to_currency, date } = validatedArgs;
+        try {
+            const rate = await this.apiClient.getExchangeRate(from_currency, to_currency, date);
+            const convertedAmount = amount * rate;
+            return {
+                amount,
+                converted_amount: Math.round(convertedAmount * 100) / 100, // Round to 2 decimal places
+                rate,
+                from_currency,
+                to_currency,
+                date: date || new Date().toISOString().split('T')[0]
+            };
+        }
+        catch (error) {
+            throw new Error(`Currency conversion failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    async getExchangeRate(args) {
+        const validatedArgs = GetExchangeRateArgsSchema.parse(args);
+        const { from_currency, to_currency, date } = validatedArgs;
+        try {
+            const rate = await this.apiClient.getExchangeRate(from_currency, to_currency, date);
+            return {
+                rate,
+                from_currency,
+                to_currency,
+                date: date || new Date().toISOString().split('T')[0]
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to get exchange rate: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}
+//# sourceMappingURL=currency-exchange-tool.js.map

package/build/tools/currency-exchange-tool.js.map

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

package/build/tools/exchange.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerCurrencyExchangeTools(server: McpServer): void;
+//# sourceMappingURL=exchange.d.ts.map

package/build/tools/exchange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange.d.ts","sourceRoot":"","sources":["../../src/tools/exchange.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiBpE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,QAyE9D"}

package/build/tools/exchange.js

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+import { Exchange } from '../programs/index.js';
+const convertCurrencySchema = z.object({
+    amount: z.number().positive().describe('The amount to convert (must be positive)'),
+    from_currency: z.string().length(3).regex(/^[A-Z]{3}$/).describe('Source currency code (3 letters, e.g., USD, EUR, NOK)'),
+    to_currency: z.string().length(3).regex(/^[A-Z]{3}$/).describe('Target currency code (3 letters, e.g., USD, EUR, NOK)'),
+    date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe('Optional date in YYYY-MM-DD format for historical rates. If not provided, uses latest rates')
+});
+const getExchangeRateSchema = z.object({
+    from_currency: z.string().length(3).regex(/^[A-Z]{3}$/).describe('Source currency code (3 letters, e.g., USD, EUR, NOK)'),
+    to_currency: z.string().length(3).regex(/^[A-Z]{3}$/).describe('Target currency code (3 letters, e.g., USD, EUR, NOK)'),
+    date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe('Optional date in YYYY-MM-DD format for historical rates. If not provided, uses latest rates')
+});
+export function registerCurrencyExchangeTools(server) {
+    server.registerTool('convert_currency', {
+        description: 'Convert an amount from one currency to another using current or historical exchange rates',
+        inputSchema: convertCurrencySchema,
+    }, async ({ amount, from_currency, to_currency, date }) => {
+        try {
+            const result = await Exchange.convertCurrency({
+                amount,
+                fromCurrency: from_currency,
+                toCurrency: to_currency,
+                date
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 4),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool('get_exchange_rate', {
+        description: 'Get the exchange rate between two currencies',
+        inputSchema: getExchangeRateSchema,
+    }, async ({ from_currency, to_currency, date }) => {
+        try {
+            const result = await Exchange.getExchangeRate({
+                fromCurrency: from_currency,
+                toCurrency: to_currency,
+                date
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 4),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=exchange.js.map

package/build/tools/exchange.js.map

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

package/build/types.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export declare const CurrencyCodeSchema: any;
+export declare const ConvertCurrencyArgsSchema: any;
+export declare const GetExchangeRateArgsSchema: any;
+export type ConvertCurrencyArgs = z.infer<typeof ConvertCurrencyArgsSchema>;
+export type GetExchangeRateArgs = z.infer<typeof GetExchangeRateArgsSchema>;
+export interface CurrencyApiResponse {
+    [key: string]: {
+        [currencyCode: string]: number;
+    };
+}
+export interface ExchangeRateResult {
+    rate: number;
+    from_currency: string;
+    to_currency: string;
+    date: string;
+}
+export interface ConversionResult extends ExchangeRateResult {
+    amount: number;
+    converted_amount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB,KAA2C,CAAC;AAE3E,eAAO,MAAM,yBAAyB,KAKpC,CAAC;AAEH,eAAO,MAAM,yBAAyB,KAIpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG;QACX,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;KAClC,CAAC;CACL;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;CAC5B"}

package/build/types.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export const CurrencyCodeSchema = z.string().length(3).regex(/^[A-Z]{3}$/);
+export const ConvertCurrencyArgsSchema = z.object({
+    amount: z.number().positive(),
+    from_currency: CurrencyCodeSchema,
+    to_currency: CurrencyCodeSchema,
+    date: z.string().optional().describe('Date in YYYY-MM-DD format. If not provided, uses latest rates')
+});
+export const GetExchangeRateArgsSchema = z.object({
+    from_currency: CurrencyCodeSchema,
+    to_currency: CurrencyCodeSchema,
+    date: z.string().optional().describe('Date in YYYY-MM-DD format. If not provided, uses latest rates')
+});
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AAE3E,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,aAAa,EAAE,kBAAkB;IACjC,WAAW,EAAE,kBAAkB;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;CACxG,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,aAAa,EAAE,kBAAkB;IACjC,WAAW,EAAE,kBAAkB;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;CACxG,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,31 @@
+{
+    "name": "currency-exchange-mcp",
+    "version": "1.0.0",
+    "description": "MCP server for currency exchange rate conversion",
+    "type": "module",
+    "main": "build/index.js",
+    "scripts": {
+        "build": "tsc",
+        "start": "node build/index.js",
+        "dev": "tsx src/index.ts",
+        "inspect": "pnpm dlx @modelcontextprotocol/inspector tsx src/index.ts",
+        "clean": "rm -rf build"
+    },
+    "keywords": [
+        "mcp",
+        "currency",
+        "exchange",
+        "rates"
+    ],
+    "author": "",
+    "license": "MIT",
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.25.1",
+        "zod": "^3.25.0"
+    },
+    "devDependencies": {
+        "@types/node": "^22.10.2",
+        "tsx": "^4.19.2",
+        "typescript": "^5.7.2"
+    }
+}

package/src/index.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerCurrencyExchangeTools } from './tools/exchange.js';
+
+const server = new McpServer({
+    name: 'currency-exchange-mcp',
+    version: '1.0.0',
+});
+
+registerCurrencyExchangeTools(server);
+
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('Currency Exchange MCP server running on stdio');
+}
+
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});

package/src/programs/exchange.ts

@@ -0,0 +1,99 @@
+interface ExchangeOptions {
+    fromCurrency: string;
+    toCurrency: string;
+    amount?: number;
+    date?: string;
+}
+
+interface ExchangeRateResult {
+    rate: number;
+    fromCurrency: string;
+    toCurrency: string;
+    date: string;
+}
+
+interface ConversionResult extends ExchangeRateResult {
+    amount: number;
+    convertedAmount: number;
+}
+
+export class Exchange {
+    private static readonly baseUrl = 'https://cdn.jsdelivr.net/npm/@fawazahmed0/currency-api';
+
+    static async getExchangeRate(options: ExchangeOptions): Promise<ExchangeRateResult> {
+        const { fromCurrency, toCurrency, date } = options;
+        const normalizedFrom = fromCurrency.toLowerCase();
+        const normalizedTo = toCurrency.toLowerCase();
+        
+        let url: string;
+        if (date) {
+            url = `${this.baseUrl}@${date}/v1/currencies/${normalizedFrom}.json`;
+        } else {
+            url = `${this.baseUrl}@latest/v1/currencies/${normalizedFrom}.json`;
+        }
+
+        try {
+            const response = await fetch(url);
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+
+            const data: any = await response.json();
+            const rates = data[normalizedFrom];
+            
+            if (!rates || !(normalizedTo in rates)) {
+                throw new Error(`Exchange rate not available for ${fromCurrency} to ${toCurrency}`);
+            }
+
+            return {
+                rate: rates[normalizedTo],
+                fromCurrency: fromCurrency.toUpperCase(),
+                toCurrency: toCurrency.toUpperCase(),
+                date: date || new Date().toISOString().split('T')[0]
+            };
+        } catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to fetch exchange rate: ${error.message}`);
+            }
+            throw new Error('Unknown error occurred while fetching exchange rate');
+        }
+    }
+
+    static async convertCurrency(options: ExchangeOptions): Promise<ConversionResult> {
+        const { amount } = options;
+        
+        if (!amount || amount <= 0) {
+            throw new Error('Amount must be provided and positive for currency conversion');
+        }
+
+        const rateResult = await this.getExchangeRate(options);
+        const convertedAmount = amount * rateResult.rate;
+
+        return {
+            ...rateResult,
+            amount,
+            convertedAmount: Math.round(convertedAmount * 100) / 100
+        };
+    }
+
+    static async getSupportedCurrencies(baseCurrency: string = 'eur'): Promise<string[]> {
+        const url = `${this.baseUrl}@latest/v1/currencies/${baseCurrency.toLowerCase()}.json`;
+        
+        try {
+            const response = await fetch(url);
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+
+            const data: any = await response.json();
+            const rates = data[baseCurrency.toLowerCase()];
+            
+            return Object.keys(rates).map(code => code.toUpperCase()).sort();
+        } catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to fetch supported currencies: ${error.message}`);
+            }
+            throw new Error('Unknown error occurred while fetching supported currencies');
+        }
+    }
+}

package/src/programs/index.ts

@@ -0,0 +1 @@
+export { Exchange } from './exchange.js';

package/src/programs/types.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+
+export const CurrencyCodeSchema = z.string().length(3).regex(/^[A-Z]{3}$/);
+
+export const ConvertCurrencyArgsSchema = z.object({
+    amount: z.number().positive(),
+    from_currency: CurrencyCodeSchema,
+    to_currency: CurrencyCodeSchema,
+    date: z.string().optional().describe('Date in YYYY-MM-DD format. If not provided, uses latest rates')
+});
+
+export const GetExchangeRateArgsSchema = z.object({
+    from_currency: CurrencyCodeSchema,
+    to_currency: CurrencyCodeSchema,
+    date: z.string().optional().describe('Date in YYYY-MM-DD format. If not provided, uses latest rates')
+});
+
+export type ConvertCurrencyArgs = z.infer<typeof ConvertCurrencyArgsSchema>;
+export type GetExchangeRateArgs = z.infer<typeof GetExchangeRateArgsSchema>;
+
+export interface CurrencyApiResponse {
+    [key: string]: {
+        [currencyCode: string]: number;
+    };
+}
+
+export interface ExchangeRateResult {
+    rate: number;
+    from_currency: string;
+    to_currency: string;
+    date: string;
+}
+
+export interface ConversionResult extends ExchangeRateResult {
+    amount: number;
+    converted_amount: number;
+}

package/src/tools/exchange.ts

@@ -0,0 +1,91 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { Exchange } from '../programs/index.js';
+
+const convertCurrencySchema = z.object({
+    amount: z.number().positive().describe('The amount to convert (must be positive)'),
+    from_currency: z.string().length(3).regex(/^[A-Z]{3}$/).describe('Source currency code (3 letters, e.g., USD, EUR, NOK)'),
+    to_currency: z.string().length(3).regex(/^[A-Z]{3}$/).describe('Target currency code (3 letters, e.g., USD, EUR, NOK)'),
+    date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe('Optional date in YYYY-MM-DD format for historical rates. If not provided, uses latest rates')
+});
+
+const getExchangeRateSchema = z.object({
+    from_currency: z.string().length(3).regex(/^[A-Z]{3}$/).describe('Source currency code (3 letters, e.g., USD, EUR, NOK)'),
+    to_currency: z.string().length(3).regex(/^[A-Z]{3}$/).describe('Target currency code (3 letters, e.g., USD, EUR, NOK)'),
+    date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe('Optional date in YYYY-MM-DD format for historical rates. If not provided, uses latest rates')
+});
+
+export function registerCurrencyExchangeTools(server: McpServer) {
+    server.registerTool(
+        'convert_currency',
+        {
+            description: 'Convert an amount from one currency to another using current or historical exchange rates',
+            inputSchema: convertCurrencySchema,
+        },
+        async ({ amount, from_currency, to_currency, date }) => {
+            try {
+                const result = await Exchange.convertCurrency({
+                    amount,
+                    fromCurrency: from_currency,
+                    toCurrency: to_currency,
+                    date
+                });
+
+                return {
+                    content: [
+                        {
+                            type: 'text' as const,
+                            text: JSON.stringify(result, null, 4),
+                        },
+                    ],
+                };
+            } catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text' as const,
+                            text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+    );
+
+    server.registerTool(
+        'get_exchange_rate',
+        {
+            description: 'Get the exchange rate between two currencies',
+            inputSchema: getExchangeRateSchema,
+        },
+        async ({ from_currency, to_currency, date }) => {
+            try {
+                const result = await Exchange.getExchangeRate({
+                    fromCurrency: from_currency,
+                    toCurrency: to_currency,
+                    date
+                });
+
+                return {
+                    content: [
+                        {
+                            type: 'text' as const,
+                            text: JSON.stringify(result, null, 4),
+                        },
+                    ],
+                };
+            } catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text' as const,
+                            text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+    );
+}

package/tsconfig.json

@@ -0,0 +1,26 @@
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "module": "ESNext",
+        "moduleResolution": "node",
+        "allowSyntheticDefaultImports": true,
+        "esModuleInterop": true,
+        "allowJs": true,
+        "outDir": "./build",
+        "rootDir": "./src",
+        "strict": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "resolveJsonModule": true,
+        "declaration": true,
+        "declarationMap": true,
+        "sourceMap": true
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "build"
+    ]
+}