Node.js MCP Server
一個使用 Node.js 和 TypeScript 實現的 Model Context Protocol (MCP) 服務器。
什麼是 MCP？
Model Context Protocol (MCP) 是一個開放標準協議，用於在 AI 模型和各種數據源、工具之間建立安全、可控的連接。MCP 允許 AI 助手：
- 訪問本地和遠程資源
- 執行工具和功能
- 維護安全的上下文邊界
- 提供結構化的能力發現
功能特性
這個 MCP 服務器提供以下工具類別：
📁 文件操作工具
read_file- 讀取文件內容write_file- 寫入文件內容list_directory- 列出目錄內容create_directory- 創建目錄delete_file- 刪除文件
🧮 計算器工具
calculate- 執行數學計算（支持基本運算和函數）convert_units- 單位轉換（長度、重量、溫度）statistics- 計算統計信息（平均值、中位數、標準差等）
💻 系統信息工具
get_system_info- 獲取系統基本信息get_current_time- 獲取當前時間和日期execute_command- 執行安全的系統命令get_network_info- 獲取網絡接口信息get_process_info- 獲取當前進程信息
安裝和使用
前置需求
- Node.js 18.0.0 或更高版本
- npm 或 yarn
安裝依賴
```bash npm install ```
建構項目
```bash npm run build ```
啟動服務器
```bash npm start ```
開發模式
```bash npm run dev ```
配置 Claude Desktop
要在 Claude Desktop 中使用這個 MCP 服務器，請在 Claude 配置文件中添加以下內容：
```json { "mcpServers": { "nodejs-mcp-server": { "command": "node", "args": ["path/to/your/dist/index.js"] } } } ```
架構說明
核心組件
- Server (index.ts) - 主要的 MCP 服務器實現
- Tool Modules - 各種功能工具的實現
fileTools.ts- 文件操作工具calculatorTools.ts- 計算工具systemTools.ts- 系統信息工具
安全考慮
- 文件操作限制在允許的路徑範圍內
- 命令執行只允許預定義的安全命令
- 數學表達式求值使用安全的解析方式
- 所有輸入都經過驗證和清理
擴展功能
要添加新的工具，請：
- 在
src/tools/目錄下創建新的工具模組 - 實現
ToolDefinition和ToolResult接口 - 在主服務器文件中註冊新工具
工具模組示例
```typescript class MyCustomTools { getToolDefinitions(): ToolDefinition[] { return [ { name: 'my_tool', description: '我的自定義工具', inputSchema: { type: 'object', properties: { param: { type: 'string', description: '參數描述' } }, required: ['param'] } } ]; }
async handleToolCall(name: string, args: Record<string, any>): Promise
測試
手動測試
```bash
建構項目
npm run build
啟動服務器並測試工具列表
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | node dist/index.js ```
測試工具調用
```bash
測試計算工具
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "calculate", "arguments": {"expression": "2 + 3 * 4"}}}' | node dist/index.js ```
故障排除
常見問題
-
模組找不到錯誤
- 確保運行了 `npm run build`
- 檢查 TypeScript 配置
-
權限錯誤
- 檢查文件路徑權限
- 確保工作目錄正確
-
連接問題
- 驗證 MCP 客戶端配置
- 檢查服務器日誌輸出
貢獻指南
歡迎提交問題報告和功能請求！請確保：
- 遵循現有的代碼風格
- 添加適當的錯誤處理
- 包含安全考慮
- 更新文檔
許可證
MIT License - 詳見 LICENSE 文件。