Yanyue MCP

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.

Category: CRM, ERP & E-commerce

Tags: consumer-goods, product-data, search, yanyue

Visit Yanyue MCP

How to install and configure Yanyue MCP

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 claude Manual 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…

Key facts

  • https://github.com/gandli/yanyue-mcp
  • CRM, ERP & E-commerce, Web Search & Research
  • consumer-goods, product-data, search, yanyue

Part of MCP Servers

Related MCP servers

  • MCP NPX Fetch — MCP NPX Fetch is an MCP server that retrieves online resources and transforms web content into structured formats including HTML,…
  • MCP Microsoft Office Bridge — MCP Microsoft Office Bridge is an MCP server that connects AI assistants like Claude to Microsoft 365 services through the…
  • MCP Naver News — MCP Naver News is an MCP server that connects AI assistants to the Naver News API, enabling automated search and…
  • MCP NIF.PT — MCP NIF.PT is an MCP server that connects LLM clients to the Portuguese NIF.PT public API to retrieve and analyze…
  • MCP Open Library — MCP Open Library is an MCP server that connects AI assistants to the Open Library catalogue API to retrieve book,…
  • MCP Omnisearch — MCP Omnisearch is an MCP server that consolidates multiple search engines, AI answer engines, and web scrapers into a unified…

What can Yanyue MCP do?

Yanyue MCP allows an AI assistant to query cigarette and tobacco information from Yanyue.cn. Through its search tool, the server retrieves technical specifications such as nicotine and tar ratings, suggested retail pricing, brand details, and user review scores. This helps users verify product authenticity, evaluate gift options, and perform consumer research directly from chat interactions.

Which MCP clients work with Yanyue MCP?

Yanyue MCP connects to any client supporting the Model Context Protocol over a standard input and output transport layer. This includes desktop applications like Claude Desktop, developer environments like Cursor, and custom agent frameworks configured to run local command-line processes. Once registered in the client settings, the model gains access to the search tool automatically.

How do I install Yanyue MCP?

You can set up Yanyue MCP by cloning its repository from GitHub and building the project using Node.js or Bun. After compiling the source files, configure your MCP client by adding the server details to your settings file, specifying the node execution command and the path to the built entry script.

What data does Yanyue MCP provide?

The server queries Yanyue.cn to fetch product listings, brand catalogs, manufacturing details, and physical specifications such as tar, nicotine, and carbon monoxide contents. It also provides pricing data and community feedback, allowing language models to answer specialized consumer inquiries with verified information from the primary source database.

  • AI Tools
  • Categories
  • Industries
  • CLI Coding Agents
  • MCP Servers
  • MCP Categories