我的第一个MCP项目

该项目展示了如何使用MCP（模型上下文协议）服务器从DummyJSON API中检索数据。该项目使用Cursor IDE和默认代理构建。

目录

• 功能
• 安装与使用
• Cursor配置
• 许可证

功能

产品API工具

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

安装与使用

前提条件

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

Cursor配置

要通过Cursor配置此MCP服务器：

1. 打开Cursor
2. 按下：
   • Windows/Linux: Ctrl + Shift + P
   • macOS: Cmd + Shift + P
3. 输入"Configure MCP Server"并选择它
4. 根据您的设置添加适当的配置：

对于不使用WSL的Windows用户或Linux用户：

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

对于WSL用户：

json
{
"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路径，请运行：

bash
which node

许可证

本项目采用MIT许可证。