Node.js MCP Server

# MCP Server 快速入門指南 ## 🚀 5分鐘快速開始 ### 第一步：確認環境 ```bash # 檢查 Node.js 版本（需要 18+） node --version # 檢查 npm 版本 npm --version ``` ### 第二步：安裝和建構 ```bash # 安裝依賴 npm install # 建構項目 npm run build ``` ### 第三步：測試服務器 ```bash # 啟動服務器 npm start # 應該看到: "MCP Server running on stdio" ``` ### 第四步：配置 Claude Desktop 1. **找到配置文件**： - Windows: `%APPDATA%\Claude\claude_desktop_config.json` - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` 2. **添加配置**： ```json { "mcpServers": { "nodejs-mcp-server": { "command": "node", "args": ["完整路徑到\\dist\\index.js"] } } } ``` 3. **重啟 Claude Desktop** ### 第五步：測試功能 在 Claude Desktop 中嘗試： - "請計算 2 + 3 * 4" - "請獲取系統信息" - "請創建一個測試文件" ## 🛠️ 可用工具速覽 | 類別 | 工具 | 功能 | |------|------|------| | 📁 文件 | `read_file` | 讀取文件 | | 📁 文件 | `write_file` | 寫入文件 | | 📁 文件 | `list_directory` | 列出目錄 | | 🧮 計算 | `calculate` | 數學計算 | | 🧮 計算 | `convert_units` | 單位轉換 | | 🧮 計算 | `statistics` | 統計分析 | | 💻 系統 | `get_system_info` | 系統信息 | | 💻 系統 | `get_current_time` | 當前時間 | | 💻 系統 | `execute_command` | 執行命令 | ## 🔧 常見問題 **Q: 服務器無法啟動？** ```bash # 重新安裝依賴 rm -rf node_modules package-lock.json npm install npm run build ``` **Q: Claude Desktop 看不到工具？** - 檢查配置文件路徑是否正確 - 確認 JSON 格式無誤 - 重啟 Claude Desktop **Q: 工具執行失敗？** - 查看服務器是否正常運行 - 檢查參數格式是否正確 - 確認文件路徑權限 ## 📚 進階學習 - 查看 `MCP_操作手冊.md` 獲取詳細說明 - 查看 `src/tools/` 了解工具實現 - 查看 `README.md` 了解項目架構 --- **🎉 恭喜！您已成功設置 MCP 服務器！**