calc-mcp-server 0.1.0

package/README.md

@@ -0,0 +1,319 @@
+# MCP Calculator
+
+一个功能强大的 MCP (Model Context Protocol) Server 计算器，提供基础算术运算和程序员计算功能。
+
+## 项目简介
+
+MCP Calculator 是一个使用 TypeScript 实现的计算器服务器，通过 MCP 协议提供各种计算功能。它支持高精度十进制运算和程序员级整数运算（包括位运算），以及进制转换和 ASCII 字符转换。
+
+## 功能特性
+
+### 基础计算器 (`basic_calculate`)
+- 支持四则运算：加 (+)、减 (-)、乘 (*)、除 (/)、取余 (%)
+- 支持括号优先级
+- 使用 Decimal.js 实现高精度计算
+- 自动处理浮点数精度问题（如 0.1 + 0.2 = 0.3）
+
+### 程序员计算器 (`programmer_calculate`)
+- 整数算术运算
+- 位运算：按位与 (&)、按位或 (|)、按位异或 (^)、按位取反 (~)
+- 位移运算：左移 (<<)、右移 (>>)、无符号右移 (>>>)
+- 支持多种字面量格式：
+  - 十进制：`42`
+  - 十六进制：`0xFF`
+  - 二进制：`0b1010`
+  - 八进制：`0o755`
+  - 字符字面量：`'A'` (自动转换为 ASCII 值)
+
+### 进制转换 (`convert_base`)
+- 支持进制：2（二进制）、8（八进制）、10（十进制）、16（十六进制）
+- 双向转换，任意进制互转
+
+### ASCII 转换 (`ascii_to_number`, `number_to_ascii`, `multiple_ascii_to_number`)
+- ASCII 字符转数值
+- 数值转 ASCII 字符
+- 批量 ASCII 字符串转数值数组
+
+## 安装方法
+
+```bash
+# 克隆仓库
+git clone <repository-url>
+cd calculator
+
+# 安装依赖
+npm install
+
+# 构建项目
+npm run build
+```
+
+## 使用方法
+
+### 作为 MCP Server 配置
+
+在 MCP 客户端配置文件中添加：
+
+```json
+{
+  "mcpServers": {
+    "calculator": {
+      "command": "node",
+      "args": ["/path/to/calculator/dist/index.js"]
+    }
+  }
+}
+```
+
+### 直接运行
+
+```bash
+# 开发模式（监听文件变化）
+npm run dev
+
+# 构建生产版本
+npm run build
+```
+
+## 可用工具列表
+
+### 1. basic_calculate
+基础算术表达式计算
+
+**参数：**
+- `expression` (string): 要计算的算术表达式
+
+**示例：**
+```
+basic_calculate("2 + 3 * 4")        // 返回: "14"
+basic_calculate("(10 - 4) / 2")     // 返回: "3"
+basic_calculate("0.1 + 0.2")        // 返回: "0.3"
+basic_calculate("15 % 4")           // 返回: "3"
+```
+
+### 2. programmer_calculate
+程序员计算器表达式计算
+
+**参数：**
+- `expression` (string): 要计算的程序员表达式
+
+**示例：**
+```
+programmer_calculate("0xA + 0x5")           // 返回: "15" (十进制)
+programmer_calculate("0b1010 & 0b1100")     // 返回: "8"
+programmer_calculate("'A' + 1")             // 返回: "66" (ASCII 'B')
+programmer_calculate("255 << 2")            // 返回: "1020"
+programmer_calculate("~0")                  // 返回: "-1"
+```
+
+### 3. convert_base
+数字进制转换
+
+**参数：**
+- `value` (string): 要转换的数值
+- `from` (number): 源进制 (2, 8, 10, 16)
+- `to` (number): 目标进制 (2, 8, 10, 16)
+
+**示例：**
+```
+convert_base("1010", 2, 10)    // 返回: { value: "10", representation: "0b1010 = 10" }
+convert_base("FF", 16, 2)      // 返回: { value: "11111111", representation: "0xFF = 0b11111111" }
+convert_base("10", 10, 16)     // 返回: { value: "A", representation: "10 = 0xA" }
+```
+
+### 4. ascii_to_number
+ASCII 字符转数值
+
+**参数：**
+- `char` (string): 单个 ASCII 字符
+
+**示例：**
+```
+ascii_to_number("A")    // 返回: { char: "A", value: 65, binary: "0b1000001", hex: "0x41" }
+```
+
+### 5. number_to_ascii
+数值转 ASCII 字符
+
+**参数：**
+- `number` (number): 数值 (0-255)
+
+**示例：**
+```
+number_to_ascii(65)     // 返回: { number: 65, char: "A", description: "Letter A" }
+```
+
+### 6. multiple_ascii_to_number
+批量 ASCII 字符串转数值数组
+
+**参数：**
+- `text` (string): ASCII 字符串
+
+**示例：**
+```
+multiple_ascii_to_number("ABC")    // 返回: { text: "ABC", values: [65, 66, 67] }
+```
+
+## 开发指南
+
+### 项目结构
+
+```
+calculator/
+├── src/
+│   ├── index.ts              # MCP Server 入口
+│   ├── mcp/
+│   │   ├── server.ts         # MCP Server 实现
+│   │   └── tools/            # MCP 工具实现
+│   │       ├── basic.ts      # 基础计算工具
+│   │       ├── programmer.ts # 程序员计算工具
+│   │       ├── conversion.ts # 进制转换工具
+│   │       └── ascii.ts      # ASCII 转换工具
+│   ├── engines/
+│   │   ├── decimal.ts        # 高精度十进制引擎
+│   │   └── programmer.ts     # 程序员计算引擎
+│   ├── parser/
+│   │   ├── lexer.ts          # 词法分析器
+│   │   ├── parser.ts         # 语法分析器
+│   │   └── ast.ts            # 抽象语法树定义
+│   └── errors/
+│       ├── types.ts          # 错误类型定义
+│       └── handler.ts        # 错误处理器
+├── test/
+│   ├── unit/                 # 单元测试
+│   └── integration/          # 集成测试
+└── dist/                     # 编译输出
+```
+
+### 可用命令
+
+```bash
+# 构建项目
+npm run build
+
+# 开发模式（监听文件变化）
+npm run dev
+
+# 运行测试
+npm run test
+
+# 运行测试（带 UI）
+npm run test:ui
+
+# 运行测试覆盖率
+npm run test:coverage
+
+# 类型检查
+npm run typecheck
+
+# 代码检查
+npm run lint
+```
+
+### 添加新工具
+
+1. 在 `src/mcp/tools/` 创建新的工具文件
+2. 实现工具函数，遵循现有工具的模式
+3. 在 `src/mcp/server.ts` 中注册新工具
+4. 添加相应的测试
+
+## 返回格式说明
+
+所有工具的返回值均为 JSON 格式：
+
+### 成功响应
+```json
+{
+  "content": [
+    {
+      "type": "text",
+      "text": "计算结果或错误信息"
+    }
+  ]
+}
+```
+
+### basic_calculate 返回格式
+```json
+{
+  "result": "计算结果字符串",
+  "expression": "原始表达式"
+}
+```
+
+### programmer_calculate 返回格式
+```json
+{
+  "result": "计算结果字符串",
+  "decimal": "十进制表示",
+  "hex": "十六进制表示",
+  "binary": "二进制表示"
+}
+```
+
+### convert_base 返回格式
+```json
+{
+  "value": "转换后的值",
+  "representation": "完整表示"
+}
+```
+
+### ASCII 工具返回格式
+```json
+{
+  "char": "字符",
+  "value": 数值,
+  "binary": "二进制表示",
+  "hex": "十六进制表示"
+}
+```
+
+## 测试覆盖
+
+项目包含全面的单元测试和集成测试：
+
+- **测试文件**: 9 个
+- **测试用例**: 229 个
+- **代码覆盖率**: 70.09% 语句覆盖
+- **分支覆盖**: 88.66%
+
+运行测试：
+```bash
+npm run test:coverage
+```
+
+## 依赖项
+
+### 运行时依赖
+- `@modelcontextprotocol/sdk`: ^1.0.4 - MCP SDK
+- `decimal.js`: ^10.4.3 - 高精度十进制运算库
+
+### 开发依赖
+- `typescript`: ^5.3.3 - TypeScript 编译器
+- `vitest`: ^1.2.0 - 测试框架
+- `@vitest/coverage-v8`: ^1.2.0 - 代码覆盖率工具
+- `@types/node`: ^20.11.0 - Node.js 类型定义
+- `eslint`: ^8.56.0 - 代码检查工具
+
+## 错误处理
+
+计算器实现了完善的错误处理机制：
+
+- **除零错误**: 清晰提示除数为零
+- **语法错误**: 指出表达式中的语法问题位置
+- **无效字符**: 识别并报告表达式中的非法字符
+- **无效进制**: 验证进制转换的参数有效性
+- **数值溢出**: 检测整数运算溢出
+
+## 许可证
+
+MIT License
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## 作者
+
+MCP Calculator Development Team

package/build/engines/decimal.d.ts

@@ -0,0 +1,10 @@
+import { Decimal } from 'decimal.js';
+import { ASTNode } from '../parser/ast.js';
+export declare class DecimalEngine {
+    evaluate(ast: ASTNode): Decimal;
+    private visit;
+    private visitLiteral;
+    private visitBinaryOp;
+    private visitUnaryOp;
+}
+//# sourceMappingURL=decimal.d.ts.map

package/build/engines/decimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../../src/engines/decimal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,OAAO,EAAqD,MAAM,kBAAkB,CAAC;AAE9F,qBAAa,aAAa;IAExB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO;IAI/B,OAAO,CAAC,KAAK;IAeb,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,YAAY;CAYrB"}

package/build/engines/decimal.js

@@ -0,0 +1,61 @@
+import { Decimal } from 'decimal.js';
+export class DecimalEngine {
+    evaluate(ast) {
+        return this.visit(ast);
+    }
+    visit(node) {
+        switch (node.type) {
+            case 'Literal':
+                return this.visitLiteral(node);
+            case 'BinaryOp':
+                return this.visitBinaryOp(node);
+            case 'UnaryOp':
+                return this.visitUnaryOp(node);
+            case 'Group':
+                return this.visit(node.expression);
+            default:
+                throw new Error(`Unknown node type: ${node.type}`);
+        }
+    }
+    visitLiteral(node) {
+        // Strip prefixes for non-decimal literals
+        const value = node.value.replace(/^(0x|0b|0o)/, '');
+        return new Decimal(value);
+    }
+    visitBinaryOp(node) {
+        const left = this.visit(node.left);
+        const right = this.visit(node.right);
+        switch (node.operator) {
+            case '+':
+                return left.plus(right);
+            case '-':
+                return left.minus(right);
+            case '*':
+                return left.times(right);
+            case '/':
+                if (right.isZero()) {
+                    throw new Error('DivisionByZero');
+                }
+                return left.dividedBy(right);
+            case '%':
+                if (right.isZero()) {
+                    throw new Error('DivisionByZero');
+                }
+                return left.modulo(right);
+            default:
+                throw new Error(`不支持运算符 "${node.operator}"，请使用程序员计算器进行此运算。`);
+        }
+    }
+    visitUnaryOp(node) {
+        const operand = this.visit(node.operand);
+        switch (node.operator) {
+            case '-':
+                return operand.negated();
+            case '+':
+                return operand;
+            default:
+                throw new Error(`Unsupported unary operator for decimal engine: ${node.operator}`);
+        }
+    }
+}
+//# sourceMappingURL=decimal.js.map

package/build/engines/decimal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.js","sourceRoot":"","sources":["../../src/engines/decimal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGrC,MAAM,OAAO,aAAa;IAExB,QAAQ,CAAC,GAAY;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAEO,KAAK,CAAC,IAAa;QACzB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,SAAS;gBACZ,OAAO,IAAI,CAAC,YAAY,CAAC,IAAmB,CAAC,CAAC;YAChD,KAAK,UAAU;gBACb,OAAO,IAAI,CAAC,aAAa,CAAC,IAAoB,CAAC,CAAC;YAClD,KAAK,SAAS;gBACZ,OAAO,IAAI,CAAC,YAAY,CAAC,IAAmB,CAAC,CAAC;YAChD,KAAK,OAAO;gBACV,OAAO,IAAI,CAAC,KAAK,CAAE,IAAkB,CAAC,UAAU,CAAC,CAAC;YACpD;gBACE,MAAM,IAAI,KAAK,CAAC,sBAAuB,IAAY,CAAC,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,IAAiB;QACpC,0CAA0C;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QACpD,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAEO,aAAa,CAAC,IAAkB;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAErC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtB,KAAK,GAAG;gBACN,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,KAAK,GAAG;gBACN,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3B,KAAK,GAAG;gBACN,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3B,KAAK,GAAG;gBACN,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;oBACnB,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;gBACpC,CAAC;gBACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC/B,KAAK,GAAG;gBACN,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;oBACnB,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;gBACpC,CAAC;gBACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5B;gBACE,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,QAAQ,mBAAmB,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,IAAiB;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEzC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtB,KAAK,GAAG;gBACN,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YAC3B,KAAK,GAAG;gBACN,OAAO,OAAO,CAAC;YACjB;gBACE,MAAM,IAAI,KAAK,CAAC,kDAAkD,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;CACF"}

package/build/engines/programmer.d.ts

@@ -0,0 +1,18 @@
+import { ASTNode } from '../parser/ast.js';
+export declare class ProgrammerEngine {
+    private errorHandler;
+    /**
+     * Evaluates an AST node and returns the result as a bigint.
+     *
+     * @param ast - The AST node to evaluate
+     * @returns The evaluation result as a bigint
+     * @throws {RuntimeError} If division by zero is attempted
+     * @throws {RuntimeError} If floating point numbers are used
+     */
+    evaluate(ast: ASTNode): bigint;
+    private visit;
+    private visitLiteral;
+    private visitBinaryOp;
+    private visitUnaryOp;
+}
+//# sourceMappingURL=programmer.d.ts.map

package/build/engines/programmer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"programmer.d.ts","sourceRoot":"","sources":["../../src/engines/programmer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAqD,MAAM,kBAAkB,CAAC;AAG9F,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAsB;IAE1C;;;;;;;OAOG;IACH,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAI9B,OAAO,CAAC,KAAK;IAeb,OAAO,CAAC,YAAY;IAyBpB,OAAO,CAAC,aAAa;IAuCrB,OAAO,CAAC,YAAY;CAcrB"}

package/build/engines/programmer.js

@@ -0,0 +1,103 @@
+import { ErrorHandler } from '../errors/handler.js';
+export class ProgrammerEngine {
+    errorHandler = new ErrorHandler();
+    /**
+     * Evaluates an AST node and returns the result as a bigint.
+     *
+     * @param ast - The AST node to evaluate
+     * @returns The evaluation result as a bigint
+     * @throws {RuntimeError} If division by zero is attempted
+     * @throws {RuntimeError} If floating point numbers are used
+     */
+    evaluate(ast) {
+        return this.visit(ast);
+    }
+    visit(node) {
+        switch (node.type) {
+            case 'Literal':
+                return this.visitLiteral(node);
+            case 'BinaryOp':
+                return this.visitBinaryOp(node);
+            case 'UnaryOp':
+                return this.visitUnaryOp(node);
+            case 'Group':
+                return this.visit(node.expression);
+            default:
+                throw new Error(`Unknown node type: ${node.type}`);
+        }
+    }
+    visitLiteral(node) {
+        const { value, tokenType } = node;
+        switch (tokenType) {
+            case 'NUMBER':
+                // Decimal integer
+                if (value.includes('.')) {
+                    throw this.errorHandler.runtimeError('InvalidNumber', 'Floating point numbers not supported in programmer mode');
+                }
+                return BigInt(value);
+            case 'HEX':
+                return BigInt(value);
+            case 'BINARY':
+                return BigInt(value);
+            case 'OCTAL':
+                return BigInt(value);
+            case 'CHAR_LITERAL':
+                // Parse char literal like 'A' or '\n'
+                const char = value.substring(1, value.length - 1);
+                return BigInt(char.charCodeAt(0));
+            default:
+                throw new Error(`Unsupported literal type: ${tokenType}`);
+        }
+    }
+    visitBinaryOp(node) {
+        const left = this.visit(node.left);
+        const right = this.visit(node.right);
+        switch (node.operator) {
+            case '+':
+                return left + right;
+            case '-':
+                return left - right;
+            case '*':
+                return left * right;
+            case '/':
+                if (right === 0n) {
+                    throw this.errorHandler.runtimeError('DivisionByZero', 'Cannot divide by zero');
+                }
+                return left / right;
+            case '%':
+                if (right === 0n) {
+                    throw this.errorHandler.runtimeError('DivisionByZero', 'Cannot divide by zero');
+                }
+                return left % right;
+            case '&':
+                return left & right;
+            case '|':
+                return left | right;
+            case '^':
+                return left ^ right;
+            case '<<':
+                return left << right;
+            case '>>':
+                return left >> right;
+            case '>>>':
+                // Unsigned right shift - convert to number, shift, back to bigint
+                return BigInt(Number(left) >>> Number(right));
+            default:
+                throw new Error(`Unsupported operator for programmer engine: ${node.operator}`);
+        }
+    }
+    visitUnaryOp(node) {
+        const operand = this.visit(node.operand);
+        switch (node.operator) {
+            case '~':
+                return ~operand;
+            case '-':
+                return -operand;
+            case '+':
+                return operand;
+            default:
+                throw new Error(`Unsupported unary operator for programmer engine: ${node.operator}`);
+        }
+    }
+}
+//# sourceMappingURL=programmer.js.map

package/build/engines/programmer.js.map

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

package/build/errors/handler.d.ts

@@ -0,0 +1,10 @@
+import { ErrorType, Position, ErrorResponse, CalculationResponse, SuccessResponse } from './types.js';
+export type { ErrorType, CalculationResponse, ErrorResponse, SuccessResponse };
+export declare class ErrorHandler {
+    private suggestions;
+    syntaxError(message: string, start: number, end: number): ErrorResponse;
+    runtimeError(type: ErrorType, message: string): ErrorResponse;
+    createError(type: ErrorType, message: string, position?: Position): ErrorResponse;
+    success(result: string, details?: SuccessResponse['details']): SuccessResponse;
+}
+//# sourceMappingURL=handler.d.ts.map

package/build/errors/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/errors/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,QAAQ,EAER,aAAa,EACb,mBAAmB,EACnB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,SAAS,EAAE,mBAAmB,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC;AAE/E,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CASjB;IAEF,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa;IAIvE,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa;IAI7D,WAAW,CACT,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,QAAQ,GAClB,aAAa;IAYhB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,GAAG,eAAe;CAO/E"}

package/build/errors/handler.js

@@ -0,0 +1,37 @@
+export class ErrorHandler {
+    suggestions = {
+        SyntaxError: 'Check your expression syntax. Ensure operators and operands are correctly placed.',
+        DivisionByZero: 'Division by zero is not allowed. Check your denominators.',
+        InvalidNumber: 'The number format is invalid. Check for typos or unsupported formats.',
+        OverflowError: 'The number is too large or too small to process.',
+        InvalidBase: 'Invalid base specified. Supported bases are 2, 8, 10, and 16.',
+        UnmatchedParen: 'Unmatched parenthesis. Ensure every opening parenthesis has a closing one.',
+        InvalidOperator: 'Invalid operator for this operation. Check supported operators.',
+        EmptyInput: 'Expression cannot be empty. Please provide a valid expression.',
+    };
+    syntaxError(message, start, end) {
+        return this.createError('SyntaxError', message, { start, end });
+    }
+    runtimeError(type, message) {
+        return this.createError(type, message);
+    }
+    createError(type, message, position) {
+        return {
+            success: false,
+            error: {
+                type,
+                message,
+                position,
+                suggestion: this.suggestions[type],
+            },
+        };
+    }
+    success(result, details) {
+        return {
+            success: true,
+            result,
+            details,
+        };
+    }
+}
+//# sourceMappingURL=handler.js.map

package/build/errors/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/errors/handler.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,YAAY;IACf,WAAW,GAA8B;QAC/C,WAAW,EAAE,mFAAmF;QAChG,cAAc,EAAE,2DAA2D;QAC3E,aAAa,EAAE,uEAAuE;QACtF,aAAa,EAAE,kDAAkD;QACjE,WAAW,EAAE,+DAA+D;QAC5E,cAAc,EAAE,4EAA4E;QAC5F,eAAe,EAAE,iEAAiE;QAClF,UAAU,EAAE,gEAAgE;KAC7E,CAAC;IAEF,WAAW,CAAC,OAAe,EAAE,KAAa,EAAE,GAAW;QACrD,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,YAAY,CAAC,IAAe,EAAE,OAAe;QAC3C,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,WAAW,CACT,IAAe,EACf,OAAe,EACf,QAAmB;QAEnB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI;gBACJ,OAAO;gBACP,QAAQ;gBACR,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;aACnC;SACF,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,MAAc,EAAE,OAAoC;QAC1D,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM;YACN,OAAO;SACR,CAAC;IACJ,CAAC;CACF"}

package/build/errors/types.d.ts

@@ -0,0 +1,25 @@
+export type ErrorType = 'SyntaxError' | 'DivisionByZero' | 'InvalidNumber' | 'OverflowError' | 'InvalidBase' | 'UnmatchedParen' | 'InvalidOperator' | 'EmptyInput';
+export interface Position {
+    start: number;
+    end: number;
+}
+export interface ErrorDetail {
+    type: ErrorType;
+    message: string;
+    position?: Position;
+    suggestion: string;
+}
+export interface SuccessResponse {
+    success: true;
+    result: string;
+    details?: {
+        expression?: string;
+        steps?: string[];
+    };
+}
+export interface ErrorResponse {
+    success: false;
+    error: ErrorDetail;
+}
+export type CalculationResponse = SuccessResponse | ErrorResponse;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/errors/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,gBAAgB,GAChB,eAAe,GACf,eAAe,GACf,aAAa,GACb,gBAAgB,GAChB,iBAAiB,GACjB,YAAY,CAAC;AAEjB,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,aAAa,CAAC"}

package/build/errors/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/errors/types.js.map

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

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,16 @@
+#!/usr/bin/env node
+import { createMCPServer } from './mcp/server.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+async function main() {
+    const server = createMCPServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // eslint-disable-next-line no-console
+    console.error('MCP Calculator server running on stdio');
+}
+main().catch((error) => {
+    // eslint-disable-next-line no-console
+    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,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;AAC1D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/mcp/server.d.ts

@@ -0,0 +1,3 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export declare function createMCPServer(): Server;
+//# sourceMappingURL=server.d.ts.map

package/build/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAsGnE,wBAAgB,eAAe,IAAI,MAAM,CAwLxC"}