{"id":"0a2aefe5-bf2b-4a34-8571-4a3093635183","slug":"chiisen-claudelocalmcp-ts","kind":"mcp","name":"ClaudeLocalMCP.ts","summary":"✅自己為 Claude 寫本地端 MCP Server (TypeScript版) 很簡單，有手就行😁","owner":"chiisen","repoUrl":"https://github.com/chiisen/ClaudeLocalMCP.ts","license":"MIT","licenseTier":"permissive","trust":"community","stars":0,"match":null,"fewStars":true,"format":"mcp","createdAt":"2025-04-09T19:42:50.000Z","addedAt":"2026-10-14T05:27:50.171Z","logoUrl":"https://avatars.githubusercontent.com/u/14128122?u=3f5ae68edcaaa994b94326af6eae3c1a5e7ad63e&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["cloud-infra"],"tags":[],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-14T23:43:18.368Z","sample":false,"url":"https://conduits.dev/tools/chiisen-claudelocalmcp-ts","language":"JavaScript","transports":["stdio"],"install":{"npm":"weather-mcp-server"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# ClaudeLocalMCP.ts\n自己為 Claude 寫本地端 MCP Server 很簡單，有手就行😁\n完整流程 Demo 的 gif 圖檔  \n![MCP開啟圖示](./images/DemoMCP.gif)\n\n# 簡介 MCP Server\nMCP Server 就像「AI 的 USB 插槽」，讓 AI 能安全地連接外部資料或工具。  \n舉例：AI 想查電腦檔案或查詢股票價格，MCP Server 就負責幫 AI 取得這些資料或執行操作。  \n## AI 有了 MCP（模型上下文協定）後，將產生以下重大影響：\n- AI 不再只是「建議者」，而能主動執行任務。例如，AI 不僅能告訴你怎麼查資料，還能直接幫你查詢資料庫、整理報表、發送郵件，甚至控制智慧家電  \n- AI 可即時存取外部資料與工具，突破只能依賴訓練知識的限制，能根據最新數據做出回應，如即時天氣、最新財經資訊等  \n- AI 回答更精確，能減少「幻覺」問題，因為可直接查證外部資料來源  \n- 開發者只需一次整合 MCP，AI 就能連接多種工具和資料，開發效率大幅提升  \n- 用戶資料安全性提升，因為存取權限可細緻控管，且多數操作在本地端執行  \n總結：MCP 讓 AI 從只能「說」進化到能「做」，大幅擴展應用範圍與價值，推動 AI 進入真正的智能代理（AI Agent）時代  \n\n## Weather MCP Server\n這是用來給 Claude 查詢指定地區的天氣資訊\n\n### 申請天氣 API 服務\n我去申請 https://openweathermap.org/ 的免費服務\n請去註冊並取得 API 金鑰 (API Key)\n\n### 在 .env 填入金鑰\n```shell\nOPENWEATHERMAP_API_KEY=你的實際API金鑰貼在這裡\n```\n將 `.env` 放在專案根目錄，或在 MCP 啟動參數中提供 `.env` 路徑。預設會讀取目前工作目錄下的 `.env`。\n\n```shell\nnpm install\nnpm run build\nnpm test\n```\n\n成功建置後，使用 Claude Desktop 的 `envPath` 參數指定專案根目錄下的 `.env`。\n\n### 安裝 Claude 桌面版\nhttps://claude.ai/download\n\n### 開啟 Claude 開發模式\n右上角 File => Settings\n開啟 Developer 模式\n\n### 設定 MCP Server 給 Claude 使用\nWindows 用戶請  \n開啟目錄 `C:\\Users\\使用者名稱\\AppData\\Roaming\\Claude`  \n檔案名稱 `claude_desktop_config.json`\n```json\n{\n    \"mcpServers\": {\n        \"weather\": {\n            \"command\": \"node\",\n            \"args\": [\n                \"D:\\\\github\\\\ClaudeLocalMCP.ts\\\\dist\\\\index.js\",\n                \"envPath=D:\\\\github\\\\chiisen\\\\ClaudeLocalMCP.ts\\\\.env\"\n            ]\n        }\n    }\n}\n```\n`envPath` 是 `.env` 檔案路徑。路徑中可包含空白或等號。也可以將 `OPENWEATHERMAP_API_KEY` 設為程序環境變數；沒有指定 `envPath` 時，伺服器會讀取工作目錄的 `.env`。\n\n工具名稱為 `get_weather`。英文城市可直接查詢；中文城市會先使用 MyMemory 翻譯。若 MyMemory 額度不足或服務無法連線，請改用英文城市名稱。翻譯與天氣服務各有 10 秒請求期限。\n\n確認一下 MCP 是否正常開啟  \n![MCP開啟圖示](./images/ClaudeMCP01.png)\n檢視一下 MCP 名稱  \n![MCP開啟圖示](./images/ClaudeMCP02.png)\n詢問時要指定地區，如: 台中天氣如何?  \nClaude 會要你確認(Allow for this chat)是否可以執行 MCP 服務\n![MCP開啟圖示](./images/ClaudeMCP03.png)\n\n### 查詢 MCP Server 執行 log\nWindows 用戶請  \n開啟目錄 `C:\\Users\\使用者名稱\\AppData\\Roaming\\Claude\\logs`\n"}