Yanyue MCP acts as a digital bridge between AI assistants and the extensive cigarette database found on Yanyue.cn. In simple terms, it functions like a specialized librarian that allows an AI to look up specific information about different brands, types, and product details. By integrating this tool, users can ask an AI questions about various products and receive accurate, real-world data directly from a primary industry source. On a more technical level, the server provides a dedicated `searchCigarettes` tool that accepts keyword strings to query the database. It operates using the Model Context Protocol (MCP) over a standard input/output (`stdio`) transport layer, which ensures a secure and reliable communication channel between the AI client and the data retrieval logic. This allows a Large Language Model (LLM) to programmatically fetch and parse structured information to provide more informed responses. For developers looking to enhance their AI systems, this server is built for high performance using Node.js or Bun. It can be easily integrated into environments like Claude Desktop through a simple JSON configuration or automated via the Smithery CLI. By adding Yanyue MCP to their workflow, developers empower their AI applications with specialized domain knowledge that goes beyond static training data, enabling the model to access fresh, specific information during live conversations.
1. Installation System Requirements: * Node.js version 18.16.0 or higher * npm version 9.5.1 or higher * Bun is recommended for better performance Via Smithery (Automatic for Claude Desktop):bash npx -y @smithery/cli install @gandli/yanyue-mcp --client claudeManual Installation: 1. Clone the repository and install dependencies: bash git clone --depth 1 git@gandli:Yanyue-mcp/Yanyue-mcp.git cd Yanyue-mcp npm install # Or use Bun: bun install 2. Build the project: bash npm run build # Or use Bun: bun run build
2. Configuration Add the following configuration to your MCP client’s config.json (e.g., Claude Desktop or Cursor configuration): json { "mcpServers": { "Yanyue_mcp": { "name": "Yanyue Cigarette Data", "description": "Fetch cigarette data from Yanyue", "type": "stdio", "command": "node", "args": ["path/to/build/index.js"] } } }Note: Replace path/to/build/index.js with the actual absolute path to the built file in your local installation.
3. Available Tools * searchCigarettes(keyword: str): Search for cigarette information and data based on a specific keyword from Yanyue.cn.
4. Example Prompts (No specific example prompts were provided in the source content, but the tool can be used by asking the model to search for cigarette details by brand or keyword.)
What you can do with Yanyue MCP
Use Case 1: Personalized Gift Selection and Evaluation Problem: In many cultures, particularly in China, cigarettes are frequently given as gifts for business or social occasions. Users often struggle to identify which brands are considered "premium," what the current market sentiment is, or which specific series within a brand is most prestigious. Solution: This MCP allows an AI assistant to query Yanyue.cn—the leading authority on tobacco data in China—to retrieve ratings, flavor profiles, and popularity rankings. The AI can then provide a curated list of recommendations based on the user's budget and the recipient's preferences. Example: A user asks, "I need to buy a carton of cigarettes as a gift for a business partner in Shanghai. My budget is 600-800 RMB. What are the highest-rated options according to Yanyue?" The AI uses searchCigarettes to pull data for brands like "Chunghwa" or "Nanjing" and summarizes the feedback and price points.
Use Case 2: Verifying Product Specifications and Authenticity Problem: Consumers and collectors often need to verify the technical specifications of a specific cigarette product, such as tar content, nicotine levels, and carbon monoxide output, either for health monitoring or to identify potential counterfeits by comparing physical packaging to official data. Solution: By using the searchCigarettes tool, an AI can quickly pull the official technical data registered on Yanyue.cn. This provides a reliable "source of truth" for the physical characteristics of the product that would otherwise require manual searching through complex databases. Example: A user asks, "What is the tar and nicotine content of the 'Huanghelou (Soft Short 1916)'?" The AI calls the MCP, retrieves the exact specifications, and presents them clearly to the user for comparison with their product packaging.
Use Case 3: Price Transparency for Consumers and Travelers Problem: The retail price of tobacco products can vary significantly between different regions and vendors. Travelers or casual buyers may not know the suggested retail price (MSRP), leading them to pay inflated "tourist prices" or buy from unscrupulous vendors. Solution: This MCP enables an AI to act as a real-time price checker. By fetching the latest data from Yanyue.cn, the AI can provide the standard market price and user-reported pricing trends, ensuring the user has a benchmark before making a purchase. Example: A traveler in a new city asks, "What is the average price for a pack of 'Guiyan (Soft High-Altitude)'? I'm at a shop that is charging 50…