🍹 Insight Daily 🪺
Aitrainee | 公众号:AI进修生
Hi,这里是Aitrainee,欢迎阅读本期新文章。
Cline 下场卷 MCP 开发,端出了个搭 MCP 服务器的 “官方攻略”。

-
访问外部 API 和服务 -
抓实时数据 -
控制应用和本地系统 -
干些纯文本搞不定的活
-
配置 Cline 的行为,用上最佳实践。 -
把 Cline 切到专门的 MCP 开发模式。 -
提供一步步的服务器搭建指南。 -
加上安全措施,比如防止手快提前完工。 -
指导你走通规划、实施和测试。
⚠️ CRITICAL: DO NOT USE attempt_completion BEFORE TESTING ⚠️
- 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
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
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
mcp install server.py -v API_KEY=key
{
"mcpServers": {
"my-server": {
"command": "python",
"args": ["server.py"],
"env": {
"API_KEY": "key"
},
"disabled": false,
"autoApprove": []
}
}
}
```
<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
上手指南
搭 MCP 服务器,几步搞定:
-
创建 .clinerules 文件 (🚨 重要)
先把上面的协议内容搞到 .clinerules 文件里,放项目根目录。这文件会让 Cline 在这个文件夹里干活时,遵循 MCP 开发协议。
-
开聊,说清楚需求
告诉 Cline 你想做啥,具体点:服务器目的、想接哪个 API/服务、需要啥特定工具/功能。
例如:
我想给 AlphaAdvantage 金融 API 搭个 MCP 服务器。 希望能获取实时股票数据、做技术分析、查公司财报。
-
跟着协议走
Cline 会自动进 PLAN MODE,带你规划:讨论范围、看 API 文档、计划认证方式、设计工具接口。准备好了,点聊天框底部的开关切到 ACT MODE 开始干活。
-
尽早给 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) – 最关键的一步
协议会直接“卡”住你,不让你完成,直到:
- 每个工具都测过。
-
确认输出结果正确。 -
测试结果都记录下来。
这不是可选项,是协议结构强制要求的。不测完,别想下一步。
官方还提供了一个案例学习的例子:AlphaAdvantage 股票分析服务器

MCP实践:Cursor + MCP:效率狂飙!一键克隆网站、自动调试错误,社区:每个人都在谈论MCP!
最新MCP托管平台:让Cursor秒变数据库专家,一键对接Github,开发效率暴增!
Blender + MCP 从入门到实践:安装、配置、插件、渲染与快捷键一文搞定!
比Playwright更高效!BrowserTools MCP 让Cursor直接控制当前浏览器,AI调试+SEO审计效率狂飙!
手把手教你配置BrowserTools MCP,Windows 和 Mac全流程,关键命令别忽略。
以下,本号知识星球(汇集ALL订阅频道合集和其他):



[1] https://docs.cline.bot/mcp-servers/mcp
点这里👇关注我,记得标星哦~
(文:AI进修生)