a-calc 3.0.0-beta.20250123.10 → 3.0.0-beta.20250123.12

package/mcp-server/README.md

@@ -48,13 +48,28 @@ npm install a-calc
 
 在 Claude Desktop 配置文件中添加：
 
-**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+**配置文件位置：**
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+- **Linux**: `~/.config/claude/claude_desktop_config.json`
 
 **方式一：使用项目本地安装（推荐）**
 
 如果你的项目已经安装了 a-calc：
 
+#### macOS / Linux
+```json
+{
+  "mcpServers": {
+    "a-calc": {
+      "command": "node",
+      "args": ["./node_modules/a-calc/mcp-server/src/index.js"]
+    }
+  }
+}
+```
+
+#### Windows
 ```json
 {
   "mcpServers": {
@@ -70,6 +85,7 @@ npm install a-calc
 
 如果项目未安装 a-calc，使用 npx 自动下载：
 
+#### macOS / Linux
 ```json
 {
   "mcpServers": {
@@ -81,6 +97,53 @@ npm install a-calc
 }
 ```
 
+#### Windows
+```json
+{
+  "mcpServers": {
+    "a-calc": {
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "a-calc", "a-calc-mcp"]
+    }
+  }
+}
+```
+
+**⚠️ Windows 重要提示：** Windows 上必须使用 `cmd /c` 包装器来执行 `npx` 命令，否则会报错：`Windows requires 'cmd /c' wrapper to execute npx`。
+
+**方式三：指定工作目录（推荐用于项目级配置）**
+
+如果你希望 MCP 服务器在特定目录下运行（例如项目根目录），可以使用 `--cwd` 参数：
+
+#### macOS / Linux
+```json
+{
+  "mcpServers": {
+    "a-calc": {
+      "command": "npx",
+      "args": ["-y", "a-calc", "a-calc-mcp", "--cwd", "/path/to/your/project"]
+    }
+  }
+}
+```
+
+#### Windows
+```json
+{
+  "mcpServers": {
+    "a-calc": {
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "a-calc", "a-calc-mcp", "--cwd", "D:\\workspace\\your-project"]
+    }
+  }
+}
+```
+
+**使用场景：**
+- 当你需要 MCP 服务器访问项目文件时
+- 当你需要相对于项目根目录的路径时
+- 当你使用全局安装但希望在项目目录下工作时
+
 > 💡 **推荐使用方式一的原因：**
 > - 启动速度更快（无需 npx 查找和下载）
 > - 使用项目已安装的版本，版本一致性更好

package/mcp-server/src/index.js

@@ -379,6 +379,24 @@ const itemTotal = calc("price * quantity | =2", item)
             required: ["topic"],
         },
     },
+    {
+        name: "debug_info",
+        description: `🔍 调试工具 - 获取 MCP 服务器的运行环境信息
+
+返回信息:
+- cwd: 当前工作目录 (process.cwd())
+- __dirname: 脚本所在目录
+- __filename: 脚本文件路径
+- node_version: Node.js 版本
+- platform: 操作系统平台
+- env: 相关环境变量
+
+用途：调试 MCP 服务器配置问题`,
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
 ];
 
 // ==================== Resources 定义 ====================
@@ -1229,6 +1247,31 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 };
             }
 
+            case "debug_info": {
+                const debugInfo = {
+                    cwd: process.cwd(),
+                    __dirname: import.meta.url,
+                    node_version: process.version,
+                    platform: process.platform,
+                    arch: process.arch,
+                    env: {
+                        HOME: process.env.HOME,
+                        USERPROFILE: process.env.USERPROFILE,
+                        PATH: process.env.PATH?.split(process.platform === 'win32' ? ';' : ':').slice(0, 5).join('\n  '),
+                        NODE_ENV: process.env.NODE_ENV,
+                    },
+                };
+
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(debugInfo, null, 2),
+                        },
+                    ],
+                };
+            }
+
             default:
                 throw new Error(`Unknown tool: ${name}`);
         }
@@ -1291,9 +1334,24 @@ server.setRequestHandler(GetPromptRequestSchema, async (request) => {
 // ==================== Start Server ====================
 
 async function main() {
+    // 解析命令行参数
+    const args = process.argv.slice(2);
+    const cwdIndex = args.indexOf('--cwd');
+
+    if (cwdIndex !== -1 && args[cwdIndex + 1]) {
+        const targetCwd = args[cwdIndex + 1];
+        try {
+            process.chdir(targetCwd);
+            console.error(`Changed working directory to: ${process.cwd()}`);
+        } catch (error) {
+            console.error(`Failed to change directory to ${targetCwd}:`, error.message);
+        }
+    }
+
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error("a-calc MCP Server running on stdio");
+    console.error(`Working directory: ${process.cwd()}`);
 }
 
 main().catch((error) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "a-calc",
-  "version": "3.0.0-beta.20250123.10",
+  "version": "3.0.0-beta.20250123.12",
   "description": "A very powerful and easy-to-use number precision calculation and formatting library.",
   "main": "./cjs/index.js",
   "exports": {