MCP Server 完全指南:从零搭建到生产部署
# MCP Server 完全指南:从零搭建到生产部署
MCP(Model Context Protocol)正在重新定义 AI 编程工具的能力边界。如果你刚接触 MCP,或者想了解如何从零搭建一个完整的 MCP Server,这篇文章就是为你准备的。
## 什么是 MCP Server?
简单说,MCP Server 是 AI 编程助手(Claude Code、Cursor、Windsurf 等)的「外挂工具包」。没有 MCP 的时候,AI 只能靠自己的训练数据回答问题——不能查最新文档、不能读你的文件、不能执行命令。
有了 MCP Server,AI 可以:
- 🔍 实时搜索网页查最新 API
- 📄 读取和编辑项目文件
- 💻 执行命令并分析结果
- 🗄️ 操作数据库
- 🔗 调用外部 API
## 快速开始:5 分钟搭建第一个 MCP Server
### 1. 环境准备
确保你有 Node.js 18+:
```bash
node -v
npm -v
```
### 2. 安装 Hermes MCP Server(推荐)
最简单的上手方式:
```bash
npm install -g hermes-mcp-server
```
配置到 Claude Code:
```json
{
"mcpServers": {
"hermes": {
"command": "hermes-mcp-server",
"args": []
}
}
}
```
### 3. 从零手动搭建(学习原理)
如果你想理解底层机制,可以自己写一个:
```bash
mkdir my-first-mcp-server
cd my-first-mcp-server
npm init -y
npm install @modelcontextprotocol/sdk
```
创建 `index.js`:
```javascript
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
const server = new Server({
name: "my-first-mcp-server",
version: "1.0.0"
}, {
capabilities: { tools: {} }
});
server.setRequestHandler("tools/list", async () => ({
tools: [{
name: "greet",
description: "向你打个招呼",
inputSchema: {
type: "object",
properties: {
name: { type: "string", description: "你的名字" }
}
}
}]
}));
server.setRequestHandler("tools/call", async (request) => {
if (request.params.name === "greet") {
const name = request.params.arguments?.name || "世界";
return {
content: [{ type: "text", text: `你好,${name}!这是你的第一个 MCP 工具 🎉` }]
};
}
throw new Error("未知工具");
});
const transport = new StdioServerTransport();
await server.connect(transport);
```
运行测试:
```bash
node index.js
```
然后用 Claude Code 或 Cursor 配置指向这个脚本即可。
## 14 个实用 MCP Server 推荐
| 工具 | 用途 | 费用 |
|------|------|------|
| Hermes MCP Server | 全能型:搜索/文件/命令/JSON | 免费5个 + Pro¥29 |
| Playwright MCP | 浏览器自动化,截图调试 | 免费 |
| GitHub MCP | 管理 PR、Issue、代码 | 免费 |
| PostgreSQL MCP | 数据库查询和管理 | 免费 |
| Filesystem MCP | 安全文件系统操作 | 免费 |
| Brave Search MCP | 网页和本地搜索 | 免费 |
| Sequential Thinking | 思维链推理增强 | 免费 |
| Memory MCP | 持久化知识存储 | 免费 |
## 常见问题
### Q: MCP Server 安全吗?
MCP Server 运行在你的本地机器上,只有你配置的 AI 工具才能调用它。但要注意:只安装你信任的 MCP Server,因为它们可以访问你的文件系统和执行命令。
### Q: 需要多少钱?
大部分基础 MCP Server 是免费的。一些高级商业版本(如 Hermes MCP Server Pro ¥29)提供了更多专业功能。总的来说,入门成本为零。
### Q: 对性能有影响吗?
MCP Server 只在 AI 工具调用时才会启动,平时不占用资源。每次调用通常只需要几百毫秒。
## 下一步
- 安装 [Hermes MCP Server](https://github.com/dengye2026/hermes-mcp-server) 体验 13 个工具集
- 阅读 [Cursor 配置教程](/blog/cursor-mcp-setup) 快速上手
- 加入 MCP 社区,分享你自己写的工具
---
*如果你觉得这篇文章有帮助,欢迎分享给更多开发者!*
← 返回博客列表