mcpField
C
ClaudeLocalMCP.ts

ClaudeLocalMCP.ts

Local
github.com/chiisenDeveloper Tools0Updated 4w ago
Repository

About ClaudeLocalMCP.ts

ClaudeLocalMCP.ts is a TypeScript project demonstrating a local weather MCP server for Claude. It provides a `get_weather` tool that queries a specified location using OpenWeatherMap, with Chinese city names translated through MyMemory.

Key features

  1. 01Query weather by location
  2. 02Use OpenWeatherMap API
  3. 03Translate Chinese city names
  4. 04Load API key from .env

Use cases

  1. 01Check weather for a specified city
  2. 02Ask Claude about weather using Chinese place names

MCP support

It implements a local MCP server for Claude and exposes the `get_weather` tool. The README describes configuring it in Claude Desktop.

#mcp#ai-agent#typescript

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

ClaudeLocalMCP.ts

自己為 Claude 寫本地端 MCP Server 很簡單，有手就行😁 完整流程 Demo 的 gif 圖檔
MCP開啟圖示

簡介 MCP Server

MCP Server 就像「AI 的 USB 插槽」，讓 AI 能安全地連接外部資料或工具。
舉例：AI 想查電腦檔案或查詢股票價格，MCP Server 就負責幫 AI 取得這些資料或執行操作。

AI 有了 MCP（模型上下文協定）後，將產生以下重大影響：

  • AI 不再只是「建議者」，而能主動執行任務。例如，AI 不僅能告訴你怎麼查資料，還能直接幫你查詢資料庫、整理報表、發送郵件，甚至控制智慧家電
  • AI 可即時存取外部資料與工具，突破只能依賴訓練知識的限制，能根據最新數據做出回應，如即時天氣、最新財經資訊等
  • AI 回答更精確，能減少「幻覺」問題，因為可直接查證外部資料來源
  • 開發者只需一次整合 MCP，AI 就能連接多種工具和資料，開發效率大幅提升
  • 用戶資料安全性提升，因為存取權限可細緻控管，且多數操作在本地端執行
    總結：MCP 讓 AI 從只能「說」進化到能「做」，大幅擴展應用範圍與價值，推動 AI 進入真正的智能代理（AI Agent）時代

Weather MCP Server

這是用來給 Claude 查詢指定地區的天氣資訊

申請天氣 API 服務

我去申請 https://openweathermap.org/ 的免費服務 請去註冊並取得 API 金鑰 (API Key)

在 .env 填入金鑰
OPENWEATHERMAP_API_KEY=你的實際API金鑰貼在這裡

將 .env 放在專案根目錄，或在 MCP 啟動參數中提供 .env 路徑。預設會讀取目前工作目錄下的 .env。

npm install
npm run build
npm test

成功建置後，使用 Claude Desktop 的 envPath 參數指定專案根目錄下的 .env。

安裝 Claude 桌面版

https://claude.ai/download

開啟 Claude 開發模式

右上角 File => Settings 開啟 Developer 模式

設定 MCP Server 給 Claude 使用

Windows 用戶請
開啟目錄 C:\Users\使用者名稱\AppData\Roaming\Claude
檔案名稱 claude_desktop_config.json

{
    "mcpServers": {
        "weather": {
            "command": "node",
            "args": [
                "D:\\github\\ClaudeLocalMCP.ts\\dist\\index.js",
                "envPath=D:\\github\\chiisen\\ClaudeLocalMCP.ts\\.env"
            ]
        }
    }
}

envPath 是 .env 檔案路徑。路徑中可包含空白或等號。也可以將 OPENWEATHERMAP_API_KEY 設為程序環境變數；沒有指定 envPath 時，伺服器會讀取工作目錄的 .env。

工具名稱為 get_weather。英文城市可直接查詢；中文城市會先使用 MyMemory 翻譯。若 MyMemory 額度不足或服務無法連線，請改用英文城市名稱。翻譯與天氣服務各有 10 秒請求期限。

確認一下 MCP 是否正常開啟
MCP開啟圖示 檢視一下 MCP 名稱
MCP開啟圖示 詢問時要指定地區，如: 台中天氣如何?
Claude 會要你確認(Allow for this chat)是否可以執行 MCP 服務 MCP開啟圖示

查詢 MCP Server 執行 log

Windows 用戶請
開啟目錄 C:\Users\使用者名稱\AppData\Roaming\Claude\logs

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.