快速构建MCP Server应用指南

Cline 是一个专注于 AI 开发的命令行工具，但构建 MCP（Model Context Protocol）Server 应用更直接的方式是使用官方的 SDK。以下是快速构建 MCP Server 的步骤：

1. 快速开始（使用 TypeScript）

安装必要依赖

npminstall@modelcontextprotocol/sdknpminstall-D typescript tsx

创建基础 MCP Server

// server.tsimport{Server}from"@modelcontextprotocol/sdk/server/index.js";import{StdioServerTransport}from"@modelcontextprotocol/sdk/server/stdio.js";constserver=newServer({name:"example-server",version:"1.0.0",},{capabilities:{tools:{},resources:{},},});// 添加工具server.setRequestHandler("tools/list",async()=>{return{tools:[{name:"get_weather",description:"获取天气信息",inputSchema:{type:"object",properties:{city:{type:"string"},},},},],};});server.setRequestHandler("tools/call",async(request)=>{if(request.params.name==="get_weather"){const{city}=request.params.argumentsas{city:string};return{content:[{type:"text",text:`${city}的天气是晴朗，25°C`,},],};}});// 启动服务器consttransport=newStdioServerTransport();awaitserver.connect(transport);console.error("MCP Server 运行中...");

运行服务器

npx tsx server.ts

2. 使用 Cline 辅助开发

虽然 Cline 不直接构建 MCP Server，但可以辅助开发：

# 使用 Cline 生成 MCP Server 代码框架cline"创建一个 MCP Server，包含文件操作工具"# 让 Cline 帮助调试cline"如何让 MCP Server 支持文件读取资源？"

3. 完整示例：文件系统 MCP Server

import{Server}from"@modelcontextprotocol/sdk/server/index.js";import{StdioServerTransport}from"@modelcontextprotocol/sdk/server/stdio.js";import{readFile,readdir}from"fs/promises";import{join}from"path";constserver=newServer({name:"filesystem-server",version:"1.0.0",},{capabilities:{resources:{subscribe:false,},tools:{},},});// 资源支持：列出目录server.setRequestHandler("resources/list",async()=>{return{resources:[{uri:"file:///",name:"根目录",mimeType:"application/json",},],};});server.setRequestHandler("resources/read",async(request)=>{consturl=newURL(request.params.uri);if(url.protocol==="file:"){constpath=url.pathname;if(path==="/"){constfiles=awaitreaddir("/");return{contents:[{type:"text",text:JSON.stringify(files,null,2),},],};}}thrownewError("Resource not found");});// 工具支持：读取文件server.setRequestHandler("tools/list",async()=>{return{tools:[{name:"read_file",description:"读取文件内容",inputSchema:{type:"object",properties:{path:{type:"string"},},required:["path"],},},],};});server.setRequestHandler("tools/call",async(request)=>{if(request.params.name==="read_file"){const{path}=request.params.argumentsas{path:string};try{constcontent=awaitreadFile(path,"utf-8");return{content:[{type:"text",text:content,},],};}catch(error){return{content:[{type:"text",text:`错误:${error}`,},],isError:true,};}}});consttransport=newStdioServerTransport();awaitserver.connect(transport);console.error("文件系统 MCP Server 已启动");

4. 调试和测试

使用 MCP Inspector 调试

# 安装 MCP Inspectornpminstall-g @modelcontextprotocol/inspector# 运行 Inspectornpx @modelcontextprotocol/inspectornodeserver.ts

在 Claude Desktop 中使用

创建配置文件：

// ~/Library/Application Support/Claude/claude_desktop_config.json (Mac){"mcpServers":{"my-server":{"command":"node","args":["/path/to/your/server.js"],"env":{}}}}

5. 项目结构建议

mcp-server/ ├── src/ │ ├── server.ts # 主服务器文件 │ ├── tools/ # 工具实现 │ ├── resources/ # 资源实现 │ └── utils.ts # 工具函数 ├── package.json ├── tsconfig.json └── README.md

6. 实用工具函数

// 创建工具响应辅助函数functioncreateToolResponse(content:string,isError=false){return{content:[{type:"text"asconst,text:content,},],isError,};}// 验证参数functionvalidateArguments(args:any,schema:any){// 实现参数验证逻辑}

快速启动命令

# 1. 初始化项目npminit -y# 2. 安装依赖npminstall@modelcontextprotocol/sdknpminstall-D typescript tsx @types/node# 3. 创建 TypeScript 配置npx tsc --init --target es2022 --module nodenext --outDir dist# 4. 创建并运行服务器touchserver.ts# 添加上述代码到 server.tsnpx tsx server.ts

MCP Server 的核心是提供资源和工具供 AI 模型使用。你可以根据需求添加数据库操作、API 调用、文件处理等能力。