AI导哈

JSONPlaceholder MCP服务器

一个提供与JSONPlaceholder API交互工具的MCP服务器，适用于测试和原型开发。

  • by chatre7
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 chatre7/jsonplaceholder-mcp

使用说明

JSON占位符MCP服务器

一个MCP（模型上下文协议）服务器，提供与JSONPlaceholder API交互的工具，这是一个用于测试和原型设计的免费假冒REST API。

特性

此MCP服务器公开了以下工具：

工具

  1. get_posts -从JSONPlaceholder检索帖子

    • 获取所有帖子
    • 通过ID获取特定帖子
    • 按用户ID筛选帖子

  2. 用户名 -检索用户信息

    • 获取所有用户
    • 通过ID获取特定用户

  3. 获取_注释 -检索评论

    • 获取所有评论
    • 按ID获取特定评论
    • 获取特定帖子的评论

  4. get_所有 - 全部取回

    • 获取所有待办事项
    • 按ID获取特定待办事项
    • 按用户ID筛选待办事项

  5. create_post -创建新帖子（模拟）

    • 需要：用户ID、标题、正文

  6. update_post -更新现有帖子（模拟）

    • 需要：id
    • 可选：用户ID、标题、正文

  7. 删除_发布 -删除帖子（模拟）

    • 需要：id

资源

  • jsonplaceholder://api-info -关于JSON占位符API的信息

安装

  1. 克隆此存储库：
git clone <repository-url>
cd jsonplaceholder-mcp
  1. 安装依赖项：
npm install
  1. 构建项目：
npm run build

用法

运行服务器

npm start

发展模式

npm run dev

观看模式（用于开发）

npm run watch

与Claude Desktop集成

要将此MCP服务器与Claude Desktop一起使用，请将以下配置添加到您的Claude Desktop配置文件中：

macOS

编辑： ~/Library/Application Support/Claude/claude_desktop_config.json

视窗

编辑： %APPDATA%/Claude/claude_desktop_config.json

Linux

编辑： ~/.config/Claude/claude_desktop_config.json

添加此配置：

{
  "mcpServers": {
    "jsonplaceholder": {
      "command": "node",
      "args": ["/absolute/path/to/jsonplaceholder-mcp/dist/index.js"]
    }
  }
}

替换 /absolute/path/to/jsonplaceholder-mcp 安装的实际路径。

Claude中的示例用法

连接后，您可以要求Claude：

  • “从JSONPlaceholder获取所有帖子”
  • “显示ID为1的用户”
  • “获取帖子1的评论”
  • “创建标题为“测试帖子”、正文为“这是一个测试”的新帖子”
  • “获取用户1的所有待办事项”
  • “用新标题更新帖子1”
  • “删除帖子1”

关于JSON占位符

JSONPlaceholder是一个免费的假REST API，用于测试和原型设计。它提供：

  • 100个帖子
  • 500条评论
  • 100张专辑
  • 5000张图片
  • 200 全部
  • 10用户

注意：所有POST、PUT、PATCH和DELETE操作都是模拟的，不会持久化到实际的服务器上。

API基本URL:https://jsonplaceholder.typicode.com

发展

本项目使用：

  • TypeScript 用于类型安全
  • @模型上下文协议/sdk -官方Anthropic MCP SDK
  • Node.js 运行时

项目结构

jsonplaceholder-mcp/
├── src/
│   └── index.ts          # Main MCP server implementation
├── dist/                 # Compiled JavaScript (generated)
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
└── README.md            # This file

许可证

麻省理工学院

贡献

欢迎投稿！请随时提交拉取请求。

相关 MCP