MCP Demo App

MCP Demo App

一个使用 TypeScript 编写的简单 Node.js/Express API 服务，用于管理产品和订单，并集成了 Model Context Protocol（MCP）。

功能

• 用于产品和订单的 RESTful API
• Bearer 令牌身份验证
• 数据存储在 JSON 文件中
• MCP 服务提供用于查询产品和订单的工具
• 使用 TypeScript 实现类型安全

项目结构

├── src/
│   ├── server.ts         # Main Express API server
│   ├── mcpServer.ts      # MCP server exposing tools
│   └── data/
│       ├── products.json # Product data
│       └── orders.json   # Order data
├── dist/                 # Compiled JS output
├── package.json          # Project metadata and scripts
├── tsconfig.json         # TypeScript config
└── .gitignore            # Ignored files

开始使用

前提条件

• Node.js（建议使用 v16+）
• npm

安装依赖

npm install

构建项目

npm run build

运行 API 服务

npm run dev   # For development (with nodemon)
npm start     # For production (after build)

运行 MCP 服务

npm run mcp

身份验证

除 /health 外，所有 API 端点都需要 Bearer 令牌。有效令牌示例：

• valid_token_123
• client_abc_token

在 Authorization 标头中包含令牌：

Authorization: Bearer valid_token_123

API 端点

健康检查

• GET /health — 返回 { status: 'ok' }

产品

• GET /products — 列出所有产品
• GET /products/:productId — 根据 ID 获取产品

订单

• GET /orders — 列出所有订单（可按 customerId 筛选）
• GET /orders/:orderId — 根据 ID 获取订单

MCP 服务工具

MCP 服务（src/mcpServer.ts）提供以下工具：

• getProductInfo(productId) — 获取产品详情及相关订单
• listProducts() — 列出所有产品
• getProductOrders(productId) — 获取某产品的所有订单
• searchProducts(query) — 按名称或类别搜索产品

示例数据

产品（src/data/products.json）

[
  { "id": "p1", "name": "Cloud Widget", "category": "Widgets", "price": 99.99 },
  { "id": "p2", "name": "Data Analyzer", "category": "Analytics", "price": 199.99 },
  { "id": "p3", "name": "API Gateway", "category": "Infrastructure", "price": 149.99 }
]

订单（src/data/orders.json）

[
  { "id": "o101", "productId": "p1", "customerId": "cust_abc", "quantity": 2, "orderDate": "2023-10-26T10:00:00Z", "status": "shipped" },
  { "id": "o102", "productId": "p2", "customerId": "cust_xyz", "quantity": 1, "orderDate": "2023-10-27T15:30:00Z", "status": "processing" },
  { "id": "o103", "productId": "p3", "customerId": "cust_abc", "quantity": 3, "orderDate": "2023-10-28T09:15:00Z", "status": "delivered" }
]

开发说明

• TypeScript 配置：参见 tsconfig.json
• 忽略的文件：dist/、node_modules/
• 数据持久化在 src/data/ 中的 JSON 文件里

许可证

MIT