🛠️ Simple MCP Example with Claude and a Local JSON HTTP Server について
macOS版 ClaudeからローカルのモックJSONサーバーを操作する、小規模なMCPサーバーの例です。MCPツールを使った投稿の取得と追加を示します。
主な機能
- 01ClaudeをローカルJSONサーバーに接続
- 02投稿の取得
- 03投稿の追加
- 04MCP Inspectorによるテスト手順
活用シーン
- 01ローカルモックAPIでMCPツールを試す
- 02Claude経由で投稿の取得と追加をテスト
MCP 対応
MCPクライアントがローカルのモックJSONサーバーにリクエストを送るためのツールを公開します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
🛠️ Claude とローカル JSON HTTP サーバーを使ったシンプルな MCP の例
このガイドでは、**Claude(MacOS デスクトップ)**を使って、MCP(Model-Computer Protocol)経由でローカルのモック JSON サーバーとやり取りする基本的な設定方法を説明します。
🧰 前提条件
🚀 ステップごとのセットアップ
1. 依存関係をインストールする
プロジェクトのルートで、必要なパッケージをインストールします。
npm install
npm run mock-api
npm run mcp-server
claude_desktop_config.json ファイル(通常は ~/.claude/ またはアプリの内部設定フォルダーにあります)を編集し、MCP サーバーの設定を追加します。
{
"mcpServers": {
"json-chat": {
"command": "node",
"args": ["/absolute/path/to/mcp-example/dist/index.js"]
}
}
}
-
Claude を再起動します
-
再起動後、Claude の入力バーの下に、🛠️ ハンマーのアイコンが付いた新しい MCP ツールが 2 つ表示されます。
-
次のようなプロンプトを Claude に送ってみてください。
「すべての投稿を取得して」
「id 500、title "created by claude"、views 123 の投稿を挿入して」
Claude は、設定した MCP ツールを使って、ローカルのモックサーバーに実際のリクエストを送信します。
Claude にプロンプトを送るときは、JSON サーバーと MCP サーバーが実行中であることを確認してください。
テスト
次を実行します。 Run
npx @modelcontextprotocol/inspector node build/index.js
その後、利用可能なすべてのリソースが http://127.0.0.1:6274/#resources に表示されます。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。