a-calc 3.0.0-beta.20250123.11 → 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

@@ -1334,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.11",
+  "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": {