Jsonplaceholder MCP

🚀 JsonPlaceholder MCP Application

A comprehensive Model Context Protocol (MCP) server that interacts with the JsonPlaceholder (https://jsonplaceholder.typicode.com) API, providing access to users, posts, albums, and related data.

🚀 Quick Start

This MCP server offers a suite of tools to interact with various endpoints of the JsonPlaceholder API.

✨ Features

👤 User Tools

• Get Users: Retrieve a list of all users.
• Get User by ID: Fetch detailed information about a specific user.
• Get User Posts: Retrieve all posts created by a specific user.
• Get User Albums: Fetch all albums created by a specific user.
• Get User Todos: Retrieve all todos associated with a specific user.

📝 Post Tools

• Get Posts: Retrieve a list of all posts.
• Get Post by ID: Fetch detailed information about a specific post.
• Get Post Comments: Retrieve all comments for a specific post.

🖼️ Album Tools

• Get Albums: Retrieve a list of all albums.
• Get Album by ID: Fetch detailed information about a specific album.
• Get Album Photos: Retrieve all photos in a specific album.

🔧 Technical Details

This application is built using the following technologies:

• TypeScript
• Zod for schema validation
• Fetch API for data retrieval

📦 Installation

Docker

1. Build

docker build -t json-place-holder .

2. Add this content to claude_desktop_config.json

{
  "mcpServers": {
    "JsonPlaceHolder 备注服务器": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "json-place-holder"]
    }
  }
}

NPX

1. Install the library

npm run install

2. Build the server

npm run build

3. Add this content to claude_desktop_config.json Note: For Windows, use the path 绝对路径\\dist\\index.js

{
  "mcpServers": {
    "JsonPlaceHolder MCP 服务器": {
      "command": "node",
      "args": [
        "绝对路径/dist/index.js"
      ]
    }
  }
}

Or run local inspection

npm run inspect