jsonplaceholder-mcp

JsonPlaceHolder MCP 应用

一个功能全面的 Model Context Protocol（MCP）服务，可与 JsonPlaceholder (https://jsonplaceholder.typicode.com) API 交互，提供对用户、帖子、相册及相关数据的访问。

🚀 功能

此 MCP 服务提供一组工具，用于与 JSONPlaceholder API 的各个端点交互：

👤 用户工具

• 获取用户：检索所有用户的列表
• 按 ID 获取用户：获取特定用户的详细信息
• 获取用户帖子：检索特定用户创建的所有帖子
• 获取用户相册：获取特定用户创建的所有相册
• 获取用户待办事项：检索与特定用户关联的所有待办事项

📝 帖子工具

• 获取帖子：检索所有帖子的列表
• 按 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