--- id: EXP-012 sequence: 12 number: "012" kind: experience slug: ai-terms-mcp-cli-llm label: 经验 012 category: AI 协作 topics: - API - CLI - MCP - AI 入门 - 网吧经营 - LLM - Agent - RAG audience: 网吧、电竞馆经营者，以及希望听懂 AI 工具、从一件小事开始使用的新手 read_minutes: 11 title: API、CLI、MCP 是什么？从网吧日常到第一次上手 subtitle: 三张图先讲明白用途，再用一份模拟营业数据练手；其他术语放在后面按需查 summary: API 是软件给程序的办事接口，CLI 是用文字命令操作软件的方式，MCP 是 AI 连接工具和资料的共同规则。从山西网吧查收入、导报表、存文件讲起，附带三天模拟数据、参考答案、接入前提、排错方法和可复用提示词。 published_at: "2026-08-14" updated_at: "2026-09-08" version: v2.0 verification: verified visibility: public publication_state: published legacy_path: "" public_url: https://aixlg.com/exp/ai-terms-mcp-cli-llm/ wechat_url: "" source_href: https://aixlg.com/exp/ai-terms-mcp-cli-llm/ source_cta: 打开 AI 工具入门指南 article_state: v2.0 定义按官方资料复核，练习数据与答案已校算；网吧工具连接为教学示意，具体软件能力须查当时文档 takeaways: - API 像办事窗口，程序按要求提交请求，软件返回结果 - CLI 像文字遥控器，用软件认识的命令完成重复操作 - MCP 让 AI 按共同规则连接工具和资料，实际能力来自接上的软件 - 新手可以先用模拟数据做出报表，再逐步接入现有系统 - 认清门店、日期、数据口径与实际文件，比记住缩写更有用 deliverables: - 三张网吧经营场景的概念解释图 - 一份可复制的三天模拟营业数据及参考答案 - 接入前提与五类常见问题的排查方法 - 按需查阅的 AI 小词典与两段可复用提示词 source_refs: - https://docs.github.com/en/rest/about-the-rest-api/about-the-rest-api - https://cli.github.com/manual/gh_api - https://modelcontextprotocol.io/docs/2026-07-28/getting-started/intro - https://modelcontextprotocol.io/docs/2026-07-28/learn/architecture - https://modelcontextprotocol.io/specification/2025-11-25/server/tools - https://pubs.opengroup.org/onlinepubs/9799919799/utilities/V3_chap02.html - https://arxiv.org/abs/2005.14165 - https://arxiv.org/abs/2005.11401 replaces: [] revisions: - version: v2.0 date: "2026-09-08" note: 围绕是什么与实际用途重编；加入山西网吧三图、模拟数据练习与答案、能力检查和排错提示，其他术语移入按需词典；沿用原网址。 - version: v1.0 date: "2026-08-14" note: 首次公开，用一间 AI 工作室解释 LLM、CLI、MCP 及相关 AI 术语。 audio: [] --- > **先记三句话：API 是软件给程序的办事窗口；CLI 是用文字命令操作软件；MCP 是 AI 接工具和资料的共同规则。** 我在山西开网吧。对我身边开网吧、电竞馆的朋友来说，查营业额、导经营报表、把文件存好，都是熟悉的事情。 咱们就拿这些事讲。先把三个词听懂，再用一份模拟数据试着做出结果。英文全称、底层协议和安装配置，可以等真正需要时再查。 **如果你只是想听懂，读完前三张图就可以；如果想动手，接着做小练习。** 后面的词典留着查，不用一次记完。 ## 先把 API、CLI、MCP 听懂 ### API：软件给程序留的办事窗口 **API 是一种接口，让程序可以按约定调用软件的功能。** 把它想成软件专门留出的办事窗口，就容易理解了。 你自己查营业额，要打开收银后台，选日期和门店，找到上机收入、饮品收入。假设经营系统开放了 API，另一个程序可以直接向窗口提交请求，意思相当于递一张取数单： > 查什么：上机、饮品的营业明细 > 哪段时间：本周 > 哪家门店：我在山西开的网吧 系统核对请求和权限后，返回对应的数据。程序拿到这些数据，就能继续汇总、生成报表。 ![程序提交本周和山西网吧的取数单，经营后台核对后返回上机及饮品营业明细。](/exp/images/ai-terms-api-shanxi-image2.png "API 的用途：让程序直接请求软件提供的数据或功能。取数单与经营后台均为概念示意。") **对你有什么用？少做重复查询、复制、粘贴的工作。** 例如每天收店后汇总营业额，有了合适的接口，程序就有机会直接取数。 API 也可以用于创建记录、保存文件，具体要看软件开放什么。并不是有一个 API Key，就能做这个软件里的所有事情；账号权限和接口能力都要匹配。 新手听到“这个系统有 API”，先问一句就很实用：**它能让我取到哪些数据，完成哪些动作？** ### CLI：用文字命令操作软件 **CLI 叫命令行界面，是按软件规定的格式输入命令，让软件执行的一种操作方式。** 它像文字遥控器。 “终端”可以先理解成电脑上输入这些命令的窗口。你把指令输进去，按回车，程序执行后给出结果或报错。 比如你要导出一份网吧经营周报。假设报表软件提供了 CLI，一条命令就可以交代：“用本周、山西这家网吧的数据，生成报表。” ![终端中的演示命令指定本周和山西门店，右侧生成包含上机、饮品收入的网吧经营周报。](/exp/images/ai-terms-cli-shanxi-image2.png "CLI 的用途：用规定格式的命令让软件执行。图中 report export 是虚构演示，不可直接照抄。") **对你有什么用？同样的操作可以重复执行，也方便交给自动化工具。** 例如每周导报表，按实际需要调整日期和门店，就能复用已有命令。 软件必须真的提供这条命令。AI 写出一行看起来很专业的文字，不代表电脑里就有这个程序。可以让助手先查官方说明，再说明命令会读取什么、生成什么。 你不用马上学编程。先知道：**有些软件，除了点按钮，还能用文字命令操作。** ### MCP：AI 接工具和资料的共同规则 **MCP 是 AI 应用与外部工具、资料进行连接的一套共同规则。** 它约定工具怎样介绍自己的用途、接受什么信息，以及怎样把调用结果交回来。 假如你对 AI 说：“查店里这周的收入，做成周报，再存进云盘。” AI 光能聊天，还交不出这份文件。它需要用上经营后台、报表工具和云盘。MCP 可以把工具说明整理成助手认识的格式： - **查经营**：给日期和门店，拿回营业明细。 - **做周报**：给数据，生成报表文件。 - **存云盘**：给文件和保存位置，返回保存结果。 ![AI 助手通过统一工具说明连接网吧经营后台、报表工具和云盘。](/exp/images/ai-terms-mcp-shanxi-image2.png "MCP 的用途：让支持它的 AI 助手按共同规则认识和调用工具，实际工作仍由相应软件完成。") **对你有什么用？让 AI 用上聊天框之外的能力。** 大家遵守共同规则，也更方便把工具接到支持 MCP 的助手里。 使用前需要三样东西：**支持 MCP 的 AI 应用、提供所需能力的工具服务、能访问目标数据的账号权限。** 有一个“连接成功”的提示，还要再确认工具列表里有没有你需要的功能。 MCP 本身不提供网吧数据，也不会让经营系统自动多出原来没有的功能。本文是在解释一种可行用途，没有声称任何具体网吧软件已经支持这套连接。 读到这里，先记住窗口、文字命令、工具连接规则这三个意思，就已经够用了。 ## 怎么做：用三天营业数据练一遍 第一次动手，可以先把数据交给 AI 处理，熟悉“交任务、拿结果、做核对”的过程。等报表要求确定，再考虑自动取数。 ### 第一步：复制这份模拟数据 下面数字完全是练习用的，**不是小龙哥网吧的真实收入**。为避免口径混淆，练习假设“上机收入”和“饮品收入”是互不重叠的两项，不包含会员充值，也没有退款。 ~~~csv 日期,门店,上机收入,饮品收入 2026-09-01,山西示例网吧,1200,180 2026-09-02,山西示例网吧,1500,240 2026-09-03,山西示例网吧,1300,210 ~~~ 可以直接把这段数据粘给 AI。若它支持读取文件，也可以存成 CSV 或表格后交给它；无需先注册开发者账号。 ### 第二步：把结果要求说清楚 ~~~text 请只根据这三天的模拟营业数据，做一份经营小结： 1. 分别汇总上机收入、饮品收入和两项合计。 2. 找出合计最高的一天，列出计算过程。 3. 只描述数据能证明的变化，不猜原因，不推算整周。 4. 如果支持生成文件，请生成可打开的表格； 否则明确说明，并先给我可复制的结果表。 保留原始数据，不发送给其他人。 ~~~ 这一步是在练习交付结果，**并不能证明你已经用上了 API 或 MCP**。如果工具没有接入经营系统，AI 处理的就是你提供的这份数据。 ### 第三步：用参考答案验一下 - 上机收入：**4000 元**。 - 饮品收入：**630 元**。 - 两项合计：**4630 元**。 - 单日合计最高：**9 月 2 日，1740 元**；计算为 1500＋240。 这里只能判断哪天更多。没有客流、活动和上机时长等资料，不能推断“因为办了电竞比赛，所以收入上涨”。三天的数据也不能直接叫完整周报。 若生成了文件，打开核对日期、门店、三行明细和合计。真正接入店里系统时，还要按系统口径区分会员充值、实际消费、退款，不能看到金额就直接相加。 ### 第四步：需要重复做，再确认接入能力 当你已经知道报表要长什么样，可以把下面这段交给软件服务商或负责配置的人： > 我想定期汇总指定门店的营业数据。请确认： > ① 是否有只读查询数据的 API，具体能取哪些字段？ > ② 是否有现成 CLI 或导出功能，能生成什么文件？ > ③ 如果要让 AI 直接调用，是否提供兼容的 MCP 工具，能做哪些动作？ > ④ 需要哪个账号和哪些权限，是否另收费，失败时如何查看原因？ 不用要求三样都配齐。先选能完成这件事的现有方式，跑通一份报表，再考虑定期执行。 ## 容易踩坑：卡住时先查这几处 **AI 只给了操作步骤。** 先看当前助手有没有读取数据、运行命令或生成文件的能力。没有工具时，换个问法也不会让它凭空访问收银后台。 **命令提示“找不到”。** 可能是程序没安装、当前环境找不到它，或命令本来就是演示。先查该软件的官方命令说明，不要把图里的虚构命令当成安装教程。 **MCP 已连接，还是查不到收入。** 看工具列表里有没有查询营业数据的功能，再核对登录的是谁、能访问哪家店。连接、功能和权限要分别确认。 **有返回结果，数字却不对。** 先核对日期范围、门店、缺失行和统计口径。会员充值与消费额、收入与退款，不能不加区分地混算。 **工具说“保存成功”，文件却找不到。** 让它给出保存位置或文件链接，再实际打开；不要只接受一段“已完成”的话。 第一次试用陌生工具，先用模拟数据或必要的少量数据。密钥放在工具指定的凭据设置里；删除记录、发送给他人这类动作，要把对象和范围说清楚。 ## 按需查阅：大模型和其他常见词 下面是配套小词典。遇到了再查，不影响你先使用前面的三个概念。 **LLM（大语言模型）**：负责理解上下文、生成文字和推理的模型。可以帮助解释营业变化、写小结，但数据得先提供或通过工具取回。AI 应用还包括界面、文件、工具与权限；应用支持什么，不只由模型决定。 **Prompt（提示词）**：你给 AI 的任务、要求和示例。“汇总这三天，只按已有数据判断”就是提示词。目标越具体，结果越容易核对。 **Context（上下文）与 Token**：上下文是模型这次实际能看到的对话、规则、文件片段和工具结果；Token 是模型处理内容时使用的小块，并不固定等于一个汉字或单词。上下文窗口有容量限制，过去聊过的内容未必每次都完整带入。 **Tool Calling（工具调用）**：模型提出“用这个工具、传这些参数”的请求，由应用安排执行，再把结果交回来。“查这家店的本周收入”可以是一次调用；MCP 是可用于工具连接的协议，工具调用也有其他实现方式。 **Agent（智能体）**：围绕目标，把模型判断、工具行动和结果检查组织起来的系统。比如先检查数据，再汇总，再打开生成文件核对；能自主做到哪一步，要看具体应用的设计和授权。 **RAG（检索增强生成）**：先检索外部资料，再把相关内容交给模型回答。比如先找店里的会员活动规则，再解释优惠。检索到的资料是否过期、是否适用，仍要核对。 **Fine-tuning（微调）与 Inference（推理）**：微调是用训练数据继续调整模型；推理是用已有模型处理当前输入、生成输出。临时上传一份报表让 AI 阅读，通常没有改变模型本身。 **Terminal、Shell、CLI**：Terminal 是终端窗口，Shell 是解释和调度命令的程序，CLI 是具体软件提供的命令行界面。先理解“在哪里输入、谁来解释、让哪个软件做事”，不用一开始就研究它们的配置。 **MCP Server、Tools、Resources、Prompts**：Server 是按 MCP 规则提供能力的程序，可以运行在本机或远端；Tools 提供可执行动作，Resources 提供可读取资料，Prompts 提供可复用模板。“Server”这个名字不代表你必须另买一台服务器。 ## 验收标准与可复用提示词 ### 怎么判断自己已经入门 能完成下面三件事，就可以往前走： 1. 用自己的话解释 API 的窗口、CLI 的文字命令、MCP 的连接规则。 2. 把模拟练习算对，并分清“AI 给的说明”和“实际能打开的文件”。 3. 说清下一个小任务要用哪份数据、生成什么结果，当前还缺什么能力。 ### 以后遇到陌生词，复制这段问 ~~~text 请把【术语】讲给没有技术背景的网吧、电竞馆经营者听。 先用一句普通话说它是什么，再用店里一个日常场景解释用途。 说明我需要准备什么，以及怎样判断它真的帮我完成了事情。 如果例子是假设或命令不能直接运行，请明确标注。 不要用一串新术语解释旧术语；暂时不用比较技术高低。 ~~~ ### 真要交一件事，复制这段改 ~~~text 我要完成：【具体任务】。 使用的数据：【文件、日期、门店】。 我想拿到：【能打开的文件或其他可核对结果】。 请先确认当前有哪些可用工具、缺哪些资料或权限。 用已具备的能力做一份样例；保留原始数据，不猜缺失信息。 完成后给出结果位置、数据范围和核对结果。 如需发送、删除或付费，先把具体对象和内容交给我确认。 ~~~ ## 来源与修订 - [GitHub API 官方说明](https://docs.github.com/en/rest/about-the-rest-api/about-the-rest-api)说明接口用于程序集成与自动化；[GitHub CLI 文档](https://cli.github.com/manual/gh_api)给出真实命令行调用实例。本文网吧接口与报表命令均为教学示意，不对应现成产品承诺。 - MCP 定义、角色与能力依据[官方入门](https://modelcontextprotocol.io/docs/2026-07-28/getting-started/intro)和[官方架构](https://modelcontextprotocol.io/docs/2026-07-28/learn/architecture)。[工具规范](https://modelcontextprotocol.io/specification/2025-11-25/server/tools)解释工具说明和调用；具体产品兼容版本仍需按其文档确认。 - Shell 参考 [POSIX Shell Command Language](https://pubs.opengroup.org/onlinepubs/9799919799/utilities/V3_chap02.html)；大语言模型和 RAG 的原始研究分别为 [Language Models are Few-Shot Learners](https://arxiv.org/abs/2005.14165) 与 [Retrieval-Augmented Generation](https://arxiv.org/abs/2005.11401)。 - **v2.0｜2026-09-08**：按“讲清是什么与用途”的要求重编，增加网吧三图、模拟练习、参考答案和排错方法；旧网址继续使用。 - **v1.0｜2026-08-14**：以 AI 工作室介绍模型、命令行和工具连接概念。 本文是入门指南。模拟数据与插画用于说明方法，真实软件的安装、接口、权限与收费以其当前官方说明为准。