香水数据库访问服务

Blue Perfumery MCP Server 是一个基于Model Context Protocol (MCP)的服务,使AI助手能够安全访问香水数据库和产品信息。

  • by recepgocmen
  • JavaScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 recepgocmen/blue-perfumery-mcp-server

使用说明

蓝色香水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 start

Claude桌面集成

添加到您的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 启动服务器

许可证

麻省理工学院