蓝色香水MCP服务器
模型上下文协议(MCP)服务器,使Claude等AI助手能够访问Blue Perfumery的香水数据库和产品信息。
什么是MCP?
模型上下文协议 是一个开放标准,允许人工智能助手安全地访问外部数据源和工具。该服务器为Claude和其他MCP兼容助手提供了直接访问Blue Perfumery产品目录的权限。
技术栈
| 技术 | 版本 | 目的 |
|---|---|---|
| Node.js | 18+ | 运行时 |
| TypeScript | 5.3+ | 类型安全 |
| MCP SDK | 0.5+ | 协议实现 |
| MongoDB | - | 数据库 |
| Mongoose | 8.0+ | ODM |
可用工具
| 工具 | 说明 |
|---|---|
list_all_perfumes | 获取该系列中的所有香水 |
get_perfume_by_id | 按ID获取特定香水 |
search_perfumes | 按名称或品牌搜索香水 |
get_perfumes_by_category | 按类别筛选(男性、女性、小众) |
get_purchase_link | 获取Shopier香水购买链接 |
安装
# Install dependencies
npm install
# Create .env file
echo "MONGODB_URI=your-mongodb-uri" > .env
# Build
npm run build
# Run
npm startClaude桌面集成
添加到您的Claude桌面配置(claude_desktop_config.json):
{
"mcpServers": {
"blue-perfumery": {
"command": "node",
"args": ["/path/to/mcp-server/dist/index.js"],
"env": {
"MONGODB_URI": "your-mongodb-connection-string"
}
}
}
}项目结构
src/
├── index.ts # MCP server entry point
├── config/
│ └── database.ts # MongoDB connection
└── models/
└── Product.ts # Perfume model示例用法
配置后,您可以询问Claude:
- “蓝色香水有什么香水?”
- “搜索木质香水”
- “给我看看男士香水”
- “获取\[香水名称\]的购买链接”
环境变量
| 变量 | 描述 |
|---|---|
MONGODB_URI | MongoDB连接字符串 |
脚本
| 命令 | 描述 |
|---|---|
npm run dev | 使用tsx开发 |
npm run build | 编译TypeScript |
npm start | 启动服务器 |
许可证
麻省理工学院
