AI 原生

茶叶 API 以 MCP 服务器形式提供.

将 Claude Desktop、Cowork 或任意 MCP 客户端接入中国茶百科全书——72 种语言的茶品与专题文章，涵盖冲泡、风土、化学、制作工序、经核实的地理标志和多语言术语表——以及 b2btea.com 茶叶企业名录。工具清单见下文；实时统计见 llms.txt.

托管版——通过 URL 连接 无需安装

将任意支持远程（Streamable HTTP）服务器的 MCP 客户端指向：

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 Actions 使用）以及 llms.txt。您的套餐和用量： 账户.