太简单了!Cline官方定义MCP开发流程,聊天式开发,让MCP搭建不再复杂。

🍹 Insight Daily 🪺

Aitrainee | 公众号:AI进修生

Hi,这里是Aitrainee,迎阅读本期新文章。

Cline 下场卷 MCP 开发,端出了个搭 MCP 服务器的 “官方攻略”。

就是要让大家用 Cline 搭 MCP 服务器更顺手、更规范。

也是让每个用 Cline 搭的 MCP 服务器都靠谱、测试过、能直接用。

MCP 服务器是干啥的?
简单说,就是给 Cline 这些 AI 助手里面的LLM装上“外挂”,能:
  • 访问外部 API 和服务
  • 抓实时数据
  • 控制应用和本地系统
  • 干些纯文本搞不定的活
没 MCP,AI 像个“宅男”。有了 MCP,AI 就能跟几乎所有数字系统打交道。

这个开发协议咋回事?
核心就是一套结构化的流程。Cline 把这套流程写进了 .clinerules 文件。
.clinerules 文件有啥用?
这是个特殊配置文件,能帮你:
  • 配置 Cline 的行为,用上最佳实践。
  • 把 Cline 切到专门的 MCP 开发模式。
  • 提供一步步的服务器搭建指南。
  • 加上安全措施,比如防止手快提前完工。
  • 指导你走通规划、实施和测试。

完整的 .clinerules 协议内容如下:
# MCP Server Development Protocol
⚠️ CRITICAL: DO NOT USE attempt_completion BEFORE TESTING ⚠️
## Step 1: Planning (PLAN MODE)- What problem does this tool solve?- What API/service will it use?- What are the authentication requirements?  □ Standard API key  □ OAuth (requires separate setup script)  □ Other credentials
## Step 2: Implementation (ACT MODE)1. Bootstrap   - For web services, JavaScript integration, or Node.js environments:     ```bash     npx @modelcontextprotocol/create-server my-server     cd my-server     npm install     ```   - For data science, ML workflows, or Python environments:     ```bash     pip install mcp     # Or with uv (recommended)     uv add "mcp[cli]"     ```
2. Core Implementation   - Use MCP SDK   - Implement comprehensive logging     - TypeScript (for web/JS projects):       ```typescript       console.error('[Setup] Initializing server...');       console.error('[API] Request to endpoint:', endpoint);       console.error('[Error] Failed with:', error);       ```     - Python (for data science/ML projects):       ```python       import logging       logging.error('[Setup] Initializing server...')       logging.error(f'[API] Request to endpoint: {endpoint}')       logging.error(f'[Error] Failed with: {str(error)}')       ```   - Add type definitions   - Handle errors with context   - Implement rate limiting if needed
3. Configuration   - Get credentials from user if needed   - Add to MCP settings:     - For TypeScript projects:       ```json       {         "mcpServers": {           "my-server": {             "command""node",             "args": ["path/to/build/index.js"],             "env": {               "API_KEY""key"             },             "disabled"false,             "autoApprove": []           }         }       }       ```     - For Python projects:       ```bash       # Directly with command line       mcp install server.py -v API_KEY=key
       # Or in settings.json       {         "mcpServers": {           "my-server": {             "command""python",             "args": ["server.py"],             "env": {               "API_KEY""key"             },             "disabled"false,             "autoApprove": []           }         }       }       ```
## Step 3: Testing (BLOCKER ⛔️)
<thinking>BEFORE using attempt_completion, I MUST verify:□ Have I tested EVERY tool?□ Have I confirmed success from the user for each test?□ Have I documented the test results?
If ANY answer is "no", I MUST NOT use attempt_completion.</thinking>
1. Test Each Tool (REQUIRED)   □ Test each tool with valid inputs   □ Verify output format is correct   ⚠️ DO NOT PROCEED UNTIL ALL TOOLS TESTED
## Step 4: Completion❗ STOP AND VERIFY:□ Every tool has been tested with valid inputs□ Output format is correct for each tool
Only after ALL tools have been tested can attempt_completion be used.
## Key Requirements- ✓ Must use MCP SDK- ✓ Must have comprehensive logging- ✓ Must test each tool individually- ✓ Must handle errors gracefully- ⛔️ NEVER skip testing before completion
有了 .clinerules 文件,Cline 会咋样?
默认用 PLAN MODE 开始,先设计再动手。
在 ACT MODE 里强制执行正确的实现模式。
强制要求测完所有工具才能完成。
全程指导你走完开发周期。

上手指南

搭 MCP 服务器,几步搞定:

  1. 创建 .clinerules 文件 (🚨 重要)

    先把上面的协议内容搞到 .clinerules 文件里,放项目根目录。这文件会让 Cline 在这个文件夹里干活时,遵循 MCP 开发协议。

  2. 开聊,说清楚需求

    告诉 Cline 你想做啥,具体点:服务器目的、想接哪个 API/服务、需要啥特定工具/功能。

    例如:

    我想给 AlphaAdvantage 金融 API 搭个 MCP 服务器。  希望能获取实时股票数据、做技术分析、查公司财报。

  3. 跟着协议走

    Cline 会自动进 PLAN MODE,带你规划:讨论范围、看 API 文档、计划认证方式、设计工具接口。准备好了,点聊天框底部的开关切到 ACT MODE 开始干活。

  4. 尽早给 API 文档

    想让 Cline 干活更利索?一开始就把官方 API 文档甩给它。

    例如:

    这是这个服务的 API 文档:  [粘贴 API 文档内容]

    把 API 细节(端点、认证、数据结构)给足,Cline 搭服务器的效率和质量会高很多。


了解两种模式

Cline 这套协议分两种模式:PLAN MODE (计划模式) 和 ACT MODE (行动模式)。

计划模式 (PLAN MODE)

简单说,就是你和 Cline 先合计合计,把服务器设计好:

  • 定好要解决啥问题。
  • 选好用哪个 API。
  • 搞清楚认证咋弄。
  • 设计好工具的接口。
  • 确定数据输出啥格式。


行动模式 (ACT MODE)

计划定了,就切换到行动模式,Cline 会帮你动手干活:

  • 搭好项目架子。
  • 写具体的代码。
  • 搞定配置。
  • 把每个部分测到位。
  • 最后完成文档。


看一下上面所说的规划、行动、测试三个步骤的演示过程:

第一步:规划 (PLANNING)

协议强制 Cline 先动脑、再动手。

这阶段,Cline 会帮你一起搞清楚:

  • MCP 服务器里要有哪些工具。
  • 具体用哪些 API。
  • 认证怎么搞定。

先把这些想明白,后面 80% 的坑都能绕开。

第二步:实施 (IMPLEMENTATION)

协议保证开发过程不跑偏:

  • 项目起步要规范。
  • MCP SDK 必须用对。
  • 日志要打得够全。
  • 类型定义要搞好。
  • 错误处理要带上上下文。

这些不只是“建议你这么做”,而是硬性要求。

第三步:测试 (TESTING) – 最关键的一步

协议会直接“卡”住你,不让你完成,直到:

  •    每个工具都测过。
  • 确认输出结果正确。
  • 测试结果都记录下来。

这不是可选项,是协议结构强制要求的。不测完,别想下一步。

One More Thing

官方还提供了一个案例学习的例子:AlphaAdvantage 股票分析服务器

(用来分析股票数据、出报告)。
https://docs.cline.bot/mcp-servers/mcp-server-from-scratch#what-are-mcp-servers
MCP是什么:Windsurf Wave3:MCP协议让AI直接读取控制台错误,自动化网页调试不用复制粘贴了!Tab智能跳转、Turbo模式。
Cline的MCP商店来了。
MCP怎么配置、报错解决:Windows下MCP报错的救星来了,1分钟教你完美解决Cursor配置问题。

MCP实践:Cursor + MCP:效率狂飙!一键克隆网站、自动调试错误,社区:每个人都在谈论MCP!

最新MCP托管平台:让Cursor秒变数据库专家,一键对接Github,开发效率暴增!

Blender + MCP 从入门到实践:安装、配置、插件、渲染与快捷键一文搞定!

比Playwright更高效!BrowserTools MCP 让Cursor直接控制当前浏览器,AI调试+SEO审计效率狂飙!

手把手教你配置BrowserTools MCP,Windows 和 Mac全流程,关键命令别忽略。

以下,本号知识星球(汇集ALL订阅频道合集和其他):

🌟 知音难求,自我修炼亦艰,抓住前沿技术的机遇,与我们一起成为创新的超级个体(把握AIGC时代的个人力量)。
参考链接:
[1] https://docs.cline.bot/mcp-servers/mcp

点这里👇关注我,记得标星哦~

(文:AI进修生)

欢迎分享

发表评论