jsonplaceholder-mcp

JsonPlaceHolder MCP アプリケーション

JsonPlaceholder（https://jsonplaceholder.typicode.com）API と連携し、ユーザー、投稿、アルバムおよび関連データにアクセスできる包括的な Model Context Protocol（MCP）サーバーです。

🚀 機能

この MCP サーバーは、JSONPlaceholder API のさまざまなエンドポイントと連携するツールを提供します。

👤 ユーザーツール

• ユーザーの取得：すべてのユーザーの一覧を取得します
• ID によるユーザーの取得：特定のユーザーの詳細を取得します
• ユーザーの投稿の取得：特定のユーザーが作成したすべての投稿を取得します
• ユーザーのアルバムの取得：特定のユーザーが作成したすべてのアルバムを取得します
• ユーザーの TODO の取得：特定のユーザーに関連付けられたすべての TODO を取得します

📝 投稿ツール

• 投稿の取得：すべての投稿の一覧を取得します
• ID による投稿の取得：特定の投稿の詳細を取得します
• 投稿コメントの取得：特定の投稿に対するすべてのコメントを取得します

🖼️ アルバムツール

• アルバムの取得：すべてのアルバムの一覧を取得します
• ID によるアルバムの取得：特定のアルバムの詳細を取得します
• アルバム写真の取得：特定のアルバム内のすべての写真を取得します

🛠️ 技術的な詳細

このアプリケーションは、次の技術を使用して構築されています。

• TypeScript
• スキーマ検証用の Zod
• データ取得用の Fetch API

Claude Desktop での使用方法

Docker

1. ビルド

docker build -t json-place-holder .

2. これを claude_desktop_config.json に追加します

{
  "mcpServers": {
    "JsonPlaceHolder Notes Server": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "json-place-holder"]
    }
  }
}

NPX

1. ライブラリをインストールします

npm run install

2. サーバーをビルドします

npm run build

3. これを claude_desktop_config.json に追加します
   注：Windows ではパスに absolute_path\\dist\\index.js を使用します

{
  "mcpServers": {
    "JsonPlaceHolder MCP Server": {
      "command": "node",
      "args": [
        "absolute_path/dist/index.js"
      ]
    }
  }
}

またはローカルで検査します

npm run inspect