ClaudeLocalMCP.ts

ClaudeLocalMCP.ts

Claude 用のローカル MCP サーバーを作るのは簡単です。誰でもできます😁 全体の流れを紹介するデモの GIF ファイル

MCP サーバーの概要

MCP サーバーは「AI の USB ポート」のようなもので、AI が外部のデータやツールに安全に接続できるようにします。
たとえば、AI がコンピューター内のファイルや株価を調べたいとき、MCP サーバーが AI に代わってデータを取得したり、操作を実行したりします。

AI が MCP（モデルコンテキストプロトコル）を使うことで、次のような大きな変化が生まれます：

• 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 モードを有効にします

Claude で使用する MCP サーバーを設定する

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 の名前を確認します
質問するときは、地域を指定してください。例：台中の天気はどうですか？
Claude から、MCP サービスを実行してよいか確認するメッセージが表示されます（Allow for this chat）

MCP サーバーの実行ログを確認する

Windows ユーザーの場合
ディレクトリ C:\Users\使用者名稱\AppData\Roaming\Claude\logs を開きます