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

这台机器的初始状态是：一个能登录的普通账号、一个空的用户目录、一份还没配过任何东西的宿主。目标很具体——两个 MCP server 都能列出工具，重启之后还能列出。

下面按真实顺序记，每一步后面跟一个验收点。验收点不过就别往下走，跳过去的代价会在最后一格一次性还给你。

## 前置检查：动手前先确认四件事

装东西之前先跑四条，任何一条不对，后面全是白费。

```bash
# 1) 出网：包源和令牌端点能不能通
curl -sI https://<包源地址> | head -1

# 2) 时间：时钟漂了 TLS 就会失败，日志只写证书校验不过
date -u

# 3) 运行身份：不要用 root
id

# 4) 磁盘与目录：给 server 一个固定工作目录
df -h ~ && mkdir -p ~/mcp/work && ls -ld ~/mcp/work
```

第一条不通就先解决出网，别急着装宿主；第二条差出几分钟就先把时间同步修好——这条最像玄学，实际是证书有效期判定。第三条如果是 uid 0，先建一个专用用户再继续，云主机上跑 MCP 用 root 等于把整个实例交出去。第四条只是把工作目录定下来，后面所有相对路径都指望它。

**验收点 0**：四条命令都有正常输出，且当前不是 root。

## 装宿主 CLI

从官方渠道装到用户级，不要覆盖镜像自带的系统包。装完先确认版本号，再看帮助里有没有配置相关子命令。

```bash
# 伪命令，按官方安装方式替换
<install-host-cli>
host-cli --version
host-cli --help
```

**验收点 1**：`--version` 有输出，`--help` 里能找到管理 MCP 配置的那组子命令。版本读不出来说明 PATH 没生效，重开一个 shell 再试，别在这个状态下继续配。

## 先配 http 型，因为它最容易验收

第一个选 http 型不是因为它更好，是因为它的失败看得见。stdio 型的失败全在子进程里，http 型的失败至少有一个状态码。

```bash
host-cli mcp add demo-http \
  --transport http \
  --url http://<内网地址>:<端口>/mcp

host-cli mcp list
```

`mcp list` 里能看到这条记录，只证明配置写进去了，不证明对面有工具。这一步常见的误判就在这里：配置成功被读成服务可用。

## 验收点 2：`tools/list` 必须是非空

```bash
host-cli mcp tools demo-http
```

要看到一串工具名，才算过。返回空数组不算过，也不算报错——按协议它是合法响应，只是这个会话里没注册任何工具。这一格我单独记一行，因为它是最容易被自己糊弄过去的地方。

空的话按顺序查三样：地址是不是本机可达、令牌有没有带上、server 那边的日志里注册阶段有没有报错。三样都正常还空着，就把这格标成「待定」，先往下走，别在这里耗一整天。

**验收点 3**：`demo-http` 的工具列表非空，且随便挑一个只读工具调用一次，返回结构符合预期。

## 再配 stdio 型，它是另一种活法

stdio 型不是「后台服务」，它是宿主的子进程，由宿主拉起、通过 stdin/stdout 通信。所以它的配置里没有地址，只有命令和参数。

```bash
host-cli mcp add demo-stdio \
  --transport stdio \
  -- <绝对路径>/<可执行文件> <参数>

host-cli mcp tools demo-stdio
```

两个细节决定成败。命令用绝对路径，别指望宿主继承你的 PATH——云上不同 shell 的 PATH 经常不一样。环境变量显式传，尤其是凭据和它要读的配置目录，继承来的环境在服务模式里往往和你手敲时不是一套。

配之前建议先手跑一遍那个命令，看它在握手之后到底注册了几个工具。手动能跑通、交给宿主就空，问题在环境和路径；手动也空，问题在 server 自己。

**验收点 4**：`demo-stdio` 的工具列表非空，同样挑一个只读工具调用一次。

## 两个一起验：五条验收点

单条通不算通，两条并存才是真实状态——工具多的那个可能把列表挤掉，stdio 那个可能因为环境被覆盖而注册不上。

| # | 验收点 | 判定 |
|---|---|---|
| 1 | `mcp list` 里两条都在 | 配置层 |
| 2 | 两条 `tools` 都非空 | 能力层 |
| 3 | 各调一个只读工具，返回结构对 | 调用层 |
| 4 | 重启宿主，两条仍非空 | 持久层 |
| 5 | 日志里注册阶段无 warning | 证据层 |

第 4 条最容易被跳过，也最容易暴露问题：配置文件在，但服务单元用的是另一个用户的工作目录，重启后一切照旧地空着。

## 把这一轮的结果记下来

验收不是「跑通一次」，是「能判断下一次为什么不通」。所以每条记录写四列：server 名、传输、工具数、失败时第一处异常。

我这一轮的结论是：http 那条一次过，stdio 那条第一次空、原因是工作目录写错。这条记录比「配好了」三个字有用得多，下次同样的空列表，我知道先去哪看。

顺带把两个数字记住，方便判断自己在哪一档：这份 153 个 server、2,601 格的矩阵里，`toolCount == 0` 的有 50 个（占 32.7%），它们贡献了 705 格 fail；传输维度上 stdio 失败率 41.4%，http 7.2%。也就是说，你手工配出来的空列表不是手气差，是这条路本来就有这么大一片坑。

## 两份材料，我分开存

上面引的 705、82.4%、47 格这些数来自采集矩阵，证据分文档、真机、协议实测三种。另一份 `traps.json` 是 17 条坑点，按 A–E 分组（配置写法 6、能力缺失 3、容量与超时 2、认证 2、生效条件 4），由规则推导而来，文件自述**不是真机实测结果**。两份不能相加，也不能互相验证：推导出的「可能失败」和矩阵里一格 fail，证据强度不同。`hosts.json` 也是规则侧输入，最后核对 2026-10-23。

## 空列表不等于这个 server 坏了

`toolCount=0` 只回答「在这台宿主上它没暴露工具」。成因至少有四种：配置写错、路径不对、权限不足、采集没取到清单。

这 50 个零工具 server 里**只有 1 个记录了启动耗时**，所以「启动完就没注册」与「清单没取到」这两种解释，现有数据分不开。705 格是准的计数，但不是「50 个坏 server」的判决。放到部署场景里更直白：你机器上那一格空，很可能只是工作目录写错了，跟 server 质量无关。

## 总结

从空机器到能调工具，真正卡人的从来不是安装步骤，而是把「配置写进去了」「进程起来了」「工具能调了」分成三次验收。

## 适合与不适合

**适合**：刚拿到一台云主机、要从零配 MCP 的人；配完发现工具列表是空的人；要给别人留一份可复现部署记录的人；需要区分「配置层/能力层/调用层」故障的人。
**不适合**：已经在本地用得好、不打算上云的人；想找一份「万能配置模板」的人——宿主字段名各家不同，模板一定会失效；只想要结论不想要验收点的人，这份记录对你没用。

标签：MCP、DeepSeek Harness、部署记录、腾讯云

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


这台机器的初始状态是：一个能登录的普通账号、一个空的用户目录、一份还没配过任何东西的宿主。目标很具体——两个 MCP server 都能列出工具，重启之后还能列出。

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

开发工具

云计算

运维

从空CVM到MCP可用的完整部署记录：含前置检查、HTTP/stdio型配置步骤，及五项验收标准。重点区分配置层、能力层与调用层故障，提供工具列表为空的排查路径，适合云主机MCP从零配置与故障诊断场景。

代码解释

云主机

JSON

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


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

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

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

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐