产品API工具

一个基于MCP服务器的项目,用于从DummyJSON API获取产品数据,支持过滤和分页功能。

  • by Demontie
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 demontie/my-first-mcp

使用说明

我的第一个MCP项目

该项目演示了MCP(模型上下文协议)服务器的使用,该服务器从 虚拟JSON API使用带有默认代理的Cursor IDE构建。

目录

特性

产品API工具

  • get_产品
    • 描述:获取具有可选过滤和分页功能的产品列表
    • 参数:
      • id (字符串,可选):按ID筛选产品
      • q (字符串,可选):按标题筛选产品
      • category (字符串,可选):按类别筛选产品
      • brand (字符串,可选):按品牌过滤产品
      • price (数字,可选):按价格过滤产品
      • rating (数字,可选):按等级过滤产品
      • skip (number,可选,默认值:0):要跳过的产品数量
      • limit (数字,可选,默认值:10):要返回的最大产品数量
    • 返回:符合指定条件的产品列表
    • 数据来源:DummyJSON API(https://dummyjson.com/products)

安装和使用

先决条件

  • Node.js(版本23或更高)
  • Docker和Docker Compose
  • WSL2(如果使用Windows)

光标配置

要使用Cursor配置此MCP服务器,请执行以下操作:

  1. 打开的游标
  2. 出版社:
    • Windows/Linux: Ctrl + Shift + P
    • macOS: Cmd + Shift + P
  3. 键入“配置MCP服务器”并选择它
  4. 根据您的设置添加适当的配置:

对于Windows(不带WSL)或Linux:

{
  "mcpServers": {
    "postgres": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

WSL用户:

{
  "mcpServers": {
    "postgres": {
      "command": "wsl.exe",
      "args": [
        "-e",
        "ABSOLUTE_PATH_TO_NODE/.nvm/versions/node/v23.11.0/bin/node",
        "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"
      ]
    }
  }
}

要查找Node.js路径,请运行:

which node

许可证

该项目根据MIT许可证获得许可。