مبني للذكاء الاصطناعي

واجهة API للشاي كخادم MCP.

اربط Claude Desktop أو Cowork أو أي عميل MCP بموسوعة الشاي الصيني — أنواع الشاي والمقالات الموضوعية بـ72 لغة، مع التحضير، وبيئة المنشأ، والكيمياء، ومراحل الإنتاج، والمؤشرات الجغرافية الموثّقة، ومسرد متعدد اللغات — وبدليل b2btea.com لشركات الشاي. الأدوات مدرجة أدناه؛ والأعداد الحية في llms.txt.

مستضاف — اتصل عبر الرابط دون تثبيت

وجّه أي عميل MCP يدعم الخوادم البعيدة (Streamable HTTP) إلى:

https://api.thetea.app/mcp

Add an Authorization: Bearer tt_… header to use a paid key — free works without one (English only).

العملاء الذين يقرؤون الخوادم البعيدة من JSON:

{
  "mcpServers": {
    "thetea": {
      "url": "https://api.thetea.app/mcp",
      "headers": { "Authorization": "Bearer tt_your_key" }
    }
  }
}

Stdio-only clients (some Claude Desktop builds) can bridge with mcp-remote:

{
  "mcpServers": {
    "thetea": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.thetea.app/mcp",
               "--header", "Authorization: Bearer tt_your_key"]
    }
  }
}

بديل — خادم Python محلي

1. Install the runtime: pip install "mcp[cli]" httpx
2. احفظ server.py في أي مكان، ودوّن مساره المطلق.
3. Add it to claude_desktop_config.json:

{
  "mcpServers": {
    "thetea": {
      "command": "python3",
      "args": ["/absolute/path/to/server.py"],
      "env": { "THETEA_KEY": "tt_your_paid_key" }
    }
  }
}

يفتح المفتاح المدفوع من صفحة الأسعار 7 لغات (Pro) أو جميع اللغات الـ72 (Expert / مدى الحياة).

الأدوات المتاحة

موسوعة الشاي

• search_tea
• get_tea
• get_tea_card
• preview_tea
• get_field
• list_teas
• compare_teas
• random_tea
• list_topics
• similar_teas
• semantic_search
• recommend_like
• ask_sommelier
• tea_map

بيانات مرجعية

• glossary
• get_term
• find_places
• tea_families
• catalog_meta
• list_infusions
• get_infusion

دليل الشركات

• search_companies
• get_company
• company_facets
• companies_for_tea

get_tea returns Markdown for reading; get_tea_card returns the same card as JSON with every field. catalog_meta lists the section and field codes that get_field accepts. Summaries written by a model are marked as machine drafts.

دليل الشركات

يفتح الخادم نفسه b2btea.com، وهو دليل لشركات الشاي حول العالم — مصانع، وتجار جملة، ومستوردون، ومصدّرون، ودور شاي، وأسواق، وتعاونيات — بـ15 لغة: الإنجليزية، والروسية، والصينية، والألمانية، والفرنسية، والإسبانية، والإيطالية، والبرتغالية، واليابانية، والكورية، والتركية، والعربية، والبولندية، والهولندية، والفيتنامية.

• search_companies filters by country, city, Chinese province, company type, tea, Chinese-tea focus and evidence level; each result links to its page on b2btea.com.
• get_company returns the card as published on b2btea.com: description, address, phone, website, contact form, teas linked to encyclopedia articles.
• company_facets counts companies by country, type, tea and region; companies_for_tea goes from an encyclopedia article to the companies that deal in that tea. The directory tags companies by tea class and a few named teas, so for most articles it falls back to the class and says so in matched.

What you will not find there: e-mail addresses, in any field. Entries come from open sources and do not claim that a company operates today; each carries its evidence level, from a website that answered a live check to a name a source mentioned. Without a key a search returns the first 10 results and no paging; company cards are always open. REST: /api/v2/companies, /api/v2/company/{slug}, /api/v2/companies/facets.

طرق أخرى للوصول

البيانات نفسها متاحة أيضًا عبر واجهة REST API، و OpenAPI كمواصفات لإجراءات GPT، وملف llms.txt. خطتك واستهلاكك: الحساب.