# 从空机器到 MCP 可用，一台 CVM 上的完整落地记录

一台干净的云主机，从装环境到 17 个宿主里能读到工具，中间只有六步。每步给出验收点。

目标 server 是 `server-time`（Python，stdio，`uvx mcp-server-time`），工具数 **2**，无认证、无资源。

## 起点：先定验收口径

验收不看面板上的连接状态——握手成功它就会变绿。真正的判据是 `tools/list` 的返回：非空，且数量对得上（应为 2）。环境基线 node v22.23.2；采集 `generatedAt` 为 2026-10-25T14:16:09Z，`mode` 为 `partial`。

## 第一步 · 安全组只开 22

stdio 型 server 是本地子进程，不经网络，安全组留一条限来源 IP 的 SSH 就够。出方向要能到包源，`uvx` 首次运行会拉 Python 包。**验收**：SSH 能连；`curl -I` 一个 registry 地址返回 200 或 30x。

## 第二步 · 装 node 与 uv

```
node -v
uvx --version
```

node 跑宿主与 Inspector，`uvx` 拉 Python server。**验收**：两条都有版本号，node 为 v22.23.2 或同大版本。

## 第三步 · 手跑一次，同时把缓存热起来

```
uvx mcp-server-time
```

进程起来不退出、不刷错误，就是正常的 stdio server 在等消息，按 Ctrl-C 结束。这一步有两个作用：确认 server 本体没问题；**把依赖缓存热起来**——首次运行本次采集到 **7889ms**，大头是解析与下载，第二次起基本归零。**验收**：进程能起且不立即退出；首次耗时在 8 秒量级。

跳过这步直接配宿主，某些宿主会记成失败：OpenCode 拉工具列表默认只等 **5000ms**（documented），冷启动可能踩线；而同一 server 在 opencode 实测 `pass`，因为缓存已热。

## 第四步 · 写配置，一家一家来

五家 CLI 宿主本次是真机覆盖的，入口各不相同：

| 宿主 | 顶层键 | 本地 stdio 要点 |
|---|---|---|
| codebuddy 2.174.0 | `mcpServers` | 项目级 `.mcp.json`，或 `~/.codebuddy.json` |
| claude-code 2.1.310 | `mcpServers` | 项目级 `.mcp.json` 需人工批准 |
| qoder 1.1.78 | `mcpServers` | 与 Claude Code 的格式兼容 |
| gemini-cli 0.65.0 | `mcpServers` | 需先 `gemini trust`，否则改不了设置 |
| opencode 1.19.4 | `mcp` | `type: local`，`command` 是数组 |

opencode 差异最大，单独给一份：

```json
{ "mcp": { "time-server": { "type": "local", "command": ["uvx", "mcp-server-time"], "timeout": 20000 } } }
```

其余四家用 `mcpServers` + `command` / `args` 的经典形状。别一次装五家，先跑通一家再复制。

**验收**：宿主不报 schema 错误，条目出现在 MCP 列表里。

## 第五步 · 逐格验收，四个判据缺一不可

| 验收点 | 判据 | 不过时先看哪 |
|---|---|---|
| 进程存活 | server 不退出 | 启动命令、路径、权限 |
| 列表非空 | `tools/list` 返回 ≥1 条 | server 侧，不是宿主 |
| 数量对得上 | 工具数 == 2 | 同名覆盖、是否被截断 |
| 调用成功 | 真调一次时间查询 | 参数格式 |

第三行最容易跳过：工具少了和工具坏了，模型侧都表现为「找不到」，截断时协议层也不报错。按宿主公开文档梳理的规则推导，Cursor 的软上限约 **40**，Windsurf 约 **100**，都按所有启用 server 累计。

## 第六步 · 把结果记成矩阵

单机跑通后，我用同样的判据过了一遍 17 个宿主：**1 个 server × 17 个宿主 = 17 格，全部 `pass`**。其中 **5 格真机**（codebuddy 2.174.0、qoder 1.1.78、claude-code 2.1.310、gemini-cli 0.65.0、opencode 1.19.4），**12 格**按文档匹配配置格式。

读法：真机格是装过、连过、调到过工具；文档格只验证配置形状，没实际安装。宿主能力类结论来自公开文档的规则推导，核对 2026-10-23。17 格全绿只说明接入路径通：零工具、超时、截断、资源原语四类失败都不在这张矩阵覆盖范围内。

## 总结

六步里最值钱的是第三和第五：先热缓存，再用列表内容验收。想对照同类插件的中文清单与安装形态见 [DeepSeek Harness Hub 插件清单](https://dpharness.com/top?utm_source=txyun&utm_medium=article)。

## 适合与不适合

**适合**：要在自有云主机上从零搭 MCP 环境的人；需要可复用验收清单的运维；给团队定接入基线的工程师。
**不适合**：用托管服务、不碰主机的读者；已经跑通多宿主、只关心容量与截断的人；想要 17 家全真机对照表的人——本次只有 5 格真机。

标签：MCP、DeepSeek Harness、云主机部署、验收清单

本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。


一台干净的云主机，从装环境到 17 个宿主里能读到工具，中间只有六步。每步给出验收点。

从空机器到 MCP 可用，一台 CVM 上的完整落地记录

人工智能

代码解释

云主机

CodeBuddy

Python

JSON

快速部署LLM、AI绘画等应用,助你玩转AIGC！


4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

从空机器到 MCP 可用，一台 CVM 上的完整落地记录-腾讯云开发者社区-腾讯云

从空机器到 MCP 可用，一台 CVM 上的完整落地记录

从空机器到 MCP 可用，一台 CVM 上的完整落地记录

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐