尧图网站建设 
教程文档人工智能【免费下载链接】mcp-for-beginnersThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable, and secure AI workflows from session setup to service orchestration.项目地址https://gitcode.com/GitHub_Trending/mc/mcp-for-beginners点击查看免费下载本文以mcp-for-beginners开源课程中「12-mcp-hosts」章节对应 03-GettingStarted/12-mcp-hosts/README.md为核心骨架系统讲解如何把 MCP Server 接入 Claude Desktop、VS CodeGitHub Copilot、Cursor、Cline、Windsurf 五类主流 AI 主机应用并深入剖析配置背后的传输协议stdio 与 Streamable HTTP、排查方法以及安全最佳实践。读完本文你将能独立完成任一主机的 MCP 服务注册、连接验证与故障定位并理解不同传输方式各自的适用场景。什么是 MCP 主机HostMCP 主机是一个能够连接 MCP Server 以扩展自身能力的 AI 应用。可以把它理解为用户直接交互的「前端界面」而 MCP Server 则是提供工具与数据的「后端能力」。用户在主机中通过自然语言或界面操作触发请求主机把请求转换为标准化的 MCP 协议消息分发给已注册的各个服务器。每个主机的配置文件格式各不相同但一旦配置完成它们都通过标准化的 MCP 协议与服务器通信因此你只需编写一次服务器即可被多种主机消费。前置条件一个可供连接的 MCP Server参见 03-GettingStarted/01-first-server/README.md 中的「创建第一个服务器」章节已安装到本机的主机应用对 JSON 配置文件的基本了解。传输方式与协议版本的注意事项[!NOTE] 本文档中指向/sse的主机配置属于面向 MCP2025-11-25版本的旧式 HTTPSSE 示例。对于 MCP2026-07-28请在支持的主机中选择Streamable HTTP传输并使用服务器配置的端点。这一点至关重要MCP 规范在2026-07-28版本中做了大规模修订协议层不再有会话sessioninitialize握手与Mcp-Session-Id头被移除每个请求都自带协议版本、方法与客户端信息详见 01-CoreConcepts/mcp-2026-07-28.md。因此在配置主机时优先选择 Streamable HTTP 并核对服务器实际暴露的端点而不是沿用旧教程里的/sse路径。1. Claude DesktopClaude Desktop是 Anthropic 官方桌面应用原生支持 MCP适合本地通过 stdio 启动服务器。安装从 Anthropic 官网claude.ai/download下载 Claude Desktop安装并使用 Anthropic 账户登录。配置Claude Desktop 使用 JSON 配置文件定义 MCP 服务器。配置文件位置macOS~/Library/Application Support/Claude/claude_desktop_config.jsonWindows%APPDATA%\Claude\claude_desktop_config.jsonLinux~/.config/Claude/claude_desktop_config.json示例配置{ mcpServers: { calculator: { command: python, args: [-m, mcp_calculator_server], env: { PYTHONPATH: /path/to/your/server } }, weather: { command: node, args: [/path/to/weather-server/build/index.js] }, database: { command: npx, args: [-y, modelcontextprotocol/server-postgres], env: { DATABASE_URL: postgresql://user:passlocalhost/mydb } } } }上述配置注册了三个 stdio 服务器Python 计算器、Node 天气服务以及通过npx拉取的 PostgreSQL 官方 MCP 服务器。npx -y会自动下载并运行包无需手动安装是注册 npm 生态服务器的常见方式。配置字段说明字段说明示例command启动服务器的可执行文件python、node、npxargs命令行参数[-m, my_server]env传递给服务器的环境变量{API_KEY: xxx}cwd服务器的工作目录/path/to/server从底层实现看这些字段对应 stdio 传输的核心机制主机把command作为子进程启动通过标准输入stdin写入 JSON-RPC 消息、从标准输出stdout读取响应env与cwd则用于控制子进程的运行环境详见 03-GettingStarted/05-stdio-server/README.md 中关于 stdio 传输如何工作的说明。测试你的配置保存配置文件完全重启 Claude Desktop退出后重新打开打开一个新对话查找 图标确认服务器已连接用自然语言请求 Claude 调用其中一个工具例如「Calculate 25 * 48」。Claude Desktop 常见问题排查服务器没有出现在列表中用 JSON 校验器检查配置语法确认command的路径正确建议使用绝对路径查看 Claude Desktop 日志Help → Show Logs。服务器启动即崩溃先在终端手动运行服务器命令确认其能独立工作检查env中的环境变量是否正确设置确认所有依赖已安装如pip list | grep mcp或npm list modelcontextprotocol/sdk。2. VS Code GitHub CopilotVS Code 通过 GitHub Copilot Chat 扩展支持 MCP是目前开发场景中最常用的主机之一。本仓库的 03-GettingStarted/04-vscode/README.md 提供了完整的逐步演练这里结合官方课程作系统讲解。前置条件VS Code 1.99已安装 GitHub Copilot 扩展已安装 GitHub Copilot Chat 扩展。配置VS Code 使用工作区内的.vscode/mcp.json或用户级settings.json管理服务器。工作区配置.vscode/mcp.json{ servers: { my-calculator: { type: stdio, command: python, args: [-m, mcp_calculator_server] }, my-database: { type: sse, url: http://localhost:8080/sse } } }用户级配置settings.json{ mcp.servers: { global-server: { type: stdio, command: npx, args: [-y, anthropic/mcp-server-memory] } }, mcp.enableLogging: true }[!NOTE] 上面示例中的type: sse属于 MCP2025-11-25时代的 HTTPSSE 旧式写法。在 MCP2026-07-28规范下应改用 Streamable HTTP并确认 VS Code 版本与服务器端点支持该传输参见 01-CoreConcepts/mcp-2026-07-28.md。通过命令行添加服务器除了图形界面你还可以用 VS Code 的code可执行文件从终端控制 MCP 服务器。向用户级配置添加服务器的命令是--add-mcp后跟 JSON 形式的服务器配置code --add-mcp {\name\:\my-server\,\command\: \uvx\,\args\: [\mcp-server-fetch\]}这种方式适合脚本化、可重复的工作流例如在初始化项目时批量注册服务器。在 VS Code 中使用 MCP打开 Copilot Chat 面板CtrlShiftI / CmdShiftI输入查看可用的 MCP 工具列表用自然语言调用工具例如「Calculate 25 * 48 using the calculator」。一个完整的实操流程如下先在项目根目录创建.vscode/mcp.json并写入服务器条目如command: node, args: [build/index.js]点击条目旁的「播放」图标启动服务器此时 Copilot Chat 的工具图标会显示可用工具数量增长点击可查看并勾选工具最后通过描述性提示词如「add 22 to 1」触发工具得到结果 23。VS Code 常见问题排查MCP 服务器无法加载打开 Output 面板选择「MCP」通道查看错误日志mcp.enableLogging: true可提供更多日志执行 CtrlShiftP → 「Developer: Reload Window」重载窗口先用 MCP Inspector 或直接运行命令确认服务器本身能独立启动。3. CursorCursor是 AI 优先的代码编辑器内置 MCP 支持配置格式与 Claude Desktop 类似。安装从 Cursor 官网cursor.sh下载并安装安装完成后登录账号。配置配置文件位置macOS~/.cursor/mcp.jsonWindows%USERPROFILE%\.cursor\mcp.jsonLinux~/.cursor/mcp.json示例配置{ mcpServers: { filesystem: { command: npx, args: [-y, modelcontextprotocol/server-filesystem, /path/to/allowed/directory] }, github: { command: npx, args: [-y, modelcontextprotocol/server-github], env: { GITHUB_TOKEN: ghp_your_token_here } } } }注意filesystem服务器的最后一个参数用于限定服务器可访问的目录白名单这对应 02-Security 中「最小权限」的实践GITHUB_TOKEN这类敏感信息不建议直接写死应使用环境变量或密钥管理方案详见下文安全最佳实践。在 Cursor 中使用 MCP打开 Cursor 的 AI 对话CtrlL / CmdLMCP 工具会自动出现在建议列表中用自然语言请求 AI 完成涉及已连接服务器的任务。4. Cline终端客户端Cline是终端形态的 MCP 客户端适合命令行工作流。文档中同时演示了环境变量、命令行参数与配置文件三种接入方式。安装npm install -g anthropic/cline配置使用环境变量export ANTHROPIC_API_KEYyour-api-key export MCP_SERVER_CALCULATORpython -m mcp_calculator_server使用命令行参数cline --mcp-server calculator:python -m mcp_calculator_server \ --mcp-server weather:node /path/to/weather/index.js配置文件~/.clinerc{ apiKey: your-api-key, mcpServers: { calculator: { command: python, args: [-m, mcp_calculator_server] } } }使用 Cline# 启动交互式会话 cline # 单次查询并调用 MCP 工具 cline Calculate the square root of 144 using the calculator # 列出可用工具 cline --list-tools--list-tools会枚举服务器注册的全部工具方便在脚本化调用前确认工具名称与参数其作用相当于在代码客户端中调用listTools参见 03-GettingStarted/02-client/README.md 中「列出服务器功能」一节。5. WindsurfWindsurf是另一款支持 MCP 的 AI 代码编辑器。安装从 Windsurf 官网codeium.com/windsurf下载并安装创建账号并登录。配置Windsurf 通过设置界面管理配置打开设置Ctrl, / Cmd,搜索「MCP」点击「Edit in settings.json」编辑配置文件。示例配置{ windsurf.mcp.servers: { my-tools: { command: python, args: [/path/to/server.py], env: {} } }, windsurf.mcp.enabled: true }windsurf.mcp.enabled是总开关置为true后上述服务器才会被加载。传输类型对比不同主机支持的传输机制不同这直接决定了你能用本地子进程服务器还是远程 HTTP 服务器主机stdioSSE/HTTPWebSocketClaude Desktop✅❌❌VS Code✅✅❌Cursor✅✅❌Cline✅✅❌Windsurf✅✅❌stdio标准输入/输出最适合由主机启动的本地服务器。主机将服务器作为子进程拉起通过 stdin/stdout 交换换行分隔的 JSON-RPC 消息服务器只能把日志写到 stderr绝不能污染 stdout这是 stdio 传输的硬性约束详见 03-GettingStarted/05-stdio-server/README.md。SSE/HTTP适合远程服务器或需要被多个客户端共享的服务器。注意当前规范中独立 SSE 传输已被弃用被Streamable HTTP取代——后者支持通知机制、更好的扩展性且被 03-GettingStarted/06-http-streaming/README.md 推荐用于生产与云端场景。常见问题与解决方案服务器无法启动先在终端手动测试服务器# Python python -m your_server_module # Node.js node /path/to/server/index.js检查命令路径尽量使用绝对路径确认可执行文件在PATH中Windows 下尤其常见。检查依赖# Python pip list | grep mcp # Node.js npm list modelcontextprotocol/sdk服务器已连接但工具不工作检查服务器日志多数主机提供日志开关如 VS Code 的mcp.enableLogging用 MCP Inspector 验证工具注册Inspector 会列出全部工具、输入模式并显示完整 JSON 响应是定位「工具未注册/参数不匹配」的利器参见 03-GettingStarted/13-mcp-inspector/README.md检查权限部分工具需要文件或网络访问权限确认主机是否授予了相应访问范围。环境变量未传递部分主机会「清洗」进程环境变量避免把宿主机全部环境泄露给服务器子进程请显式使用配置中的env字段声明需要传递的变量不要在配置文件中存放敏感信息改用密钥管理服务或环境变量间接引用。安全最佳实践无论使用哪种主机以下原则都应遵守绝不把 API 密钥提交进配置文件如 Git 仓库中的mcp.json使用环境变量或密钥管理承载敏感数据把服务器权限限制到最小必要范围如server-filesystem只授权指定目录授予系统访问权限前先审查服务器代码npx -y拉取的第三方包尤其需要留意对文件系统与网络访问使用 allowlist白名单。这些原则与本仓库 02-Security/README.md 中的安全章节一脉相承面对不可信的工具结果与服务器内容主机应用需要额外的防御纵深。深入原理主机背后的协议与验证工具理解了上述配置再看几处底层机制会有助于排查问题stdio 是「进程即传输」客户端负责以commandargs启动服务器子进程双方只在 stdin/stdout 上交换换行分隔的 JSON-RPC 消息。因此配置中的command/args/env/cwd本质上就是在定义子进程的启动方式。远程传输正在换代/sse是 MCP2025-11-25的遗留配置2026-07-28规范要求使用 Streamable HTTP并以MCP-Protocol-Version、Mcp-Method、Mcp-Name等头部描述每次自包含的请求见 01-CoreConcepts/mcp-2026-07-28.md。配置新主机时优先选择 Streamable HTTP。用 MCP Inspector 做独立验证不需要完整主机应用即可测试服务器——npx modelcontextprotocol/inspector python server.py会启动本地 Web 界面展示已注册的工具、资源、提示词以及完整的 JSON-RPC 消息流是连接主机前的「第一道质检」详见 03-GettingStarted/13-mcp-inspector/README.md。下一步3.13 - 使用 MCP Inspector 调试3.1 - 创建你的第一个 MCP 服务器模块 5 - 高级主题赞分享教程文档人工智能【免费下载链接】mcp-for-beginnersThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable, and secure AI workflows from session setup to service orchestration.项目地址https://gitcode.com/GitHub_Trending/mc/mcp-for-beginners点击查看免费下载相关推荐主流 MCP 主机客户端配置实战Claude Desktop、VS Code、Cursor、Cline 与 Windsurf 全指南主流 MCP 主机客户端配置实战Claude Desktop、VS Code、Cursor、Cline 与 Windsurf 全指南 MCP 服务器Serv教程文档人工智能MCP Hosts 实战指南在 Claude Desktop、VS Code、Cursor、Cline 与 Windsurf 中配置与使用 MCP 服务器MCP Hosts 实战指南在 Claude Desktop、VS Code、Cursor、Cline 与 Windsurf 中配置与使用 MCP 服务器 本教程文档人工智能Thorium浏览器按指令集编译的Chromium,给嫌默认版慢的人Thorium浏览器按指令集编译的Chromium,给嫌默认版慢的人 你有多久没在意过浏览器的冷启动时间了多数人把打开浏览器慢当成理所当然其实从按下图桌面应用跨平台上一篇Aspire CLI 安装路线旁车install-route sidecar机制一个 JSON 文件如何决定 CLI 的目录布局与状态位置下一篇智能图片去重革命AntiDupl.NET如何拯救你的数字存储空间创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 MCP 主机客户端配置实战：Claude Desktop、VS Code、Cursor、Cline 与 Windsurf 接入指南
教程文档人工智能【免费下载链接】mcp-for-beginnersThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable, and secure AI workflows from session setup to service orchestration.项目地址https://gitcode.com/GitHub_Trending/mc/mcp-for-beginners点击查看免费下载本文以mcp-for-beginners开源课程中「12-mcp-hosts」章节对应 03-GettingStarted/12-mcp-hosts/README.md为核心骨架系统讲解如何把 MCP Server 接入 Claude Desktop、VS CodeGitHub Copilot、Cursor、Cline、Windsurf 五类主流 AI 主机应用并深入剖析配置背后的传输协议stdio 与 Streamable HTTP、排查方法以及安全最佳实践。读完本文你将能独立完成任一主机的 MCP 服务注册、连接验证与故障定位并理解不同传输方式各自的适用场景。什么是 MCP 主机HostMCP 主机是一个能够连接 MCP Server 以扩展自身能力的 AI 应用。可以把它理解为用户直接交互的「前端界面」而 MCP Server 则是提供工具与数据的「后端能力」。用户在主机中通过自然语言或界面操作触发请求主机把请求转换为标准化的 MCP 协议消息分发给已注册的各个服务器。每个主机的配置文件格式各不相同但一旦配置完成它们都通过标准化的 MCP 协议与服务器通信因此你只需编写一次服务器即可被多种主机消费。前置条件一个可供连接的 MCP Server参见 03-GettingStarted/01-first-server/README.md 中的「创建第一个服务器」章节已安装到本机的主机应用对 JSON 配置文件的基本了解。传输方式与协议版本的注意事项[!NOTE] 本文档中指向/sse的主机配置属于面向 MCP2025-11-25版本的旧式 HTTPSSE 示例。对于 MCP2026-07-28请在支持的主机中选择Streamable HTTP传输并使用服务器配置的端点。这一点至关重要MCP 规范在2026-07-28版本中做了大规模修订协议层不再有会话sessioninitialize握手与Mcp-Session-Id头被移除每个请求都自带协议版本、方法与客户端信息详见 01-CoreConcepts/mcp-2026-07-28.md。因此在配置主机时优先选择 Streamable HTTP 并核对服务器实际暴露的端点而不是沿用旧教程里的/sse路径。1. Claude DesktopClaude Desktop是 Anthropic 官方桌面应用原生支持 MCP适合本地通过 stdio 启动服务器。安装从 Anthropic 官网claude.ai/download下载 Claude Desktop安装并使用 Anthropic 账户登录。配置Claude Desktop 使用 JSON 配置文件定义 MCP 服务器。配置文件位置macOS~/Library/Application Support/Claude/claude_desktop_config.jsonWindows%APPDATA%\Claude\claude_desktop_config.jsonLinux~/.config/Claude/claude_desktop_config.json示例配置{ mcpServers: { calculator: { command: python, args: [-m, mcp_calculator_server], env: { PYTHONPATH: /path/to/your/server } }, weather: { command: node, args: [/path/to/weather-server/build/index.js] }, database: { command: npx, args: [-y, modelcontextprotocol/server-postgres], env: { DATABASE_URL: postgresql://user:passlocalhost/mydb } } } }上述配置注册了三个 stdio 服务器Python 计算器、Node 天气服务以及通过npx拉取的 PostgreSQL 官方 MCP 服务器。npx -y会自动下载并运行包无需手动安装是注册 npm 生态服务器的常见方式。配置字段说明字段说明示例command启动服务器的可执行文件python、node、npxargs命令行参数[-m, my_server]env传递给服务器的环境变量{API_KEY: xxx}cwd服务器的工作目录/path/to/server从底层实现看这些字段对应 stdio 传输的核心机制主机把command作为子进程启动通过标准输入stdin写入 JSON-RPC 消息、从标准输出stdout读取响应env与cwd则用于控制子进程的运行环境详见 03-GettingStarted/05-stdio-server/README.md 中关于 stdio 传输如何工作的说明。测试你的配置保存配置文件完全重启 Claude Desktop退出后重新打开打开一个新对话查找 图标确认服务器已连接用自然语言请求 Claude 调用其中一个工具例如「Calculate 25 * 48」。Claude Desktop 常见问题排查服务器没有出现在列表中用 JSON 校验器检查配置语法确认command的路径正确建议使用绝对路径查看 Claude Desktop 日志Help → Show Logs。服务器启动即崩溃先在终端手动运行服务器命令确认其能独立工作检查env中的环境变量是否正确设置确认所有依赖已安装如pip list | grep mcp或npm list modelcontextprotocol/sdk。2. VS Code GitHub CopilotVS Code 通过 GitHub Copilot Chat 扩展支持 MCP是目前开发场景中最常用的主机之一。本仓库的 03-GettingStarted/04-vscode/README.md 提供了完整的逐步演练这里结合官方课程作系统讲解。前置条件VS Code 1.99已安装 GitHub Copilot 扩展已安装 GitHub Copilot Chat 扩展。配置VS Code 使用工作区内的.vscode/mcp.json或用户级settings.json管理服务器。工作区配置.vscode/mcp.json{ servers: { my-calculator: { type: stdio, command: python, args: [-m, mcp_calculator_server] }, my-database: { type: sse, url: http://localhost:8080/sse } } }用户级配置settings.json{ mcp.servers: { global-server: { type: stdio, command: npx, args: [-y, anthropic/mcp-server-memory] } }, mcp.enableLogging: true }[!NOTE] 上面示例中的type: sse属于 MCP2025-11-25时代的 HTTPSSE 旧式写法。在 MCP2026-07-28规范下应改用 Streamable HTTP并确认 VS Code 版本与服务器端点支持该传输参见 01-CoreConcepts/mcp-2026-07-28.md。通过命令行添加服务器除了图形界面你还可以用 VS Code 的code可执行文件从终端控制 MCP 服务器。向用户级配置添加服务器的命令是--add-mcp后跟 JSON 形式的服务器配置code --add-mcp {\name\:\my-server\,\command\: \uvx\,\args\: [\mcp-server-fetch\]}这种方式适合脚本化、可重复的工作流例如在初始化项目时批量注册服务器。在 VS Code 中使用 MCP打开 Copilot Chat 面板CtrlShiftI / CmdShiftI输入查看可用的 MCP 工具列表用自然语言调用工具例如「Calculate 25 * 48 using the calculator」。一个完整的实操流程如下先在项目根目录创建.vscode/mcp.json并写入服务器条目如command: node, args: [build/index.js]点击条目旁的「播放」图标启动服务器此时 Copilot Chat 的工具图标会显示可用工具数量增长点击可查看并勾选工具最后通过描述性提示词如「add 22 to 1」触发工具得到结果 23。VS Code 常见问题排查MCP 服务器无法加载打开 Output 面板选择「MCP」通道查看错误日志mcp.enableLogging: true可提供更多日志执行 CtrlShiftP → 「Developer: Reload Window」重载窗口先用 MCP Inspector 或直接运行命令确认服务器本身能独立启动。3. CursorCursor是 AI 优先的代码编辑器内置 MCP 支持配置格式与 Claude Desktop 类似。安装从 Cursor 官网cursor.sh下载并安装安装完成后登录账号。配置配置文件位置macOS~/.cursor/mcp.jsonWindows%USERPROFILE%\.cursor\mcp.jsonLinux~/.cursor/mcp.json示例配置{ mcpServers: { filesystem: { command: npx, args: [-y, modelcontextprotocol/server-filesystem, /path/to/allowed/directory] }, github: { command: npx, args: [-y, modelcontextprotocol/server-github], env: { GITHUB_TOKEN: ghp_your_token_here } } } }注意filesystem服务器的最后一个参数用于限定服务器可访问的目录白名单这对应 02-Security 中「最小权限」的实践GITHUB_TOKEN这类敏感信息不建议直接写死应使用环境变量或密钥管理方案详见下文安全最佳实践。在 Cursor 中使用 MCP打开 Cursor 的 AI 对话CtrlL / CmdLMCP 工具会自动出现在建议列表中用自然语言请求 AI 完成涉及已连接服务器的任务。4. Cline终端客户端Cline是终端形态的 MCP 客户端适合命令行工作流。文档中同时演示了环境变量、命令行参数与配置文件三种接入方式。安装npm install -g anthropic/cline配置使用环境变量export ANTHROPIC_API_KEYyour-api-key export MCP_SERVER_CALCULATORpython -m mcp_calculator_server使用命令行参数cline --mcp-server calculator:python -m mcp_calculator_server \ --mcp-server weather:node /path/to/weather/index.js配置文件~/.clinerc{ apiKey: your-api-key, mcpServers: { calculator: { command: python, args: [-m, mcp_calculator_server] } } }使用 Cline# 启动交互式会话 cline # 单次查询并调用 MCP 工具 cline Calculate the square root of 144 using the calculator # 列出可用工具 cline --list-tools--list-tools会枚举服务器注册的全部工具方便在脚本化调用前确认工具名称与参数其作用相当于在代码客户端中调用listTools参见 03-GettingStarted/02-client/README.md 中「列出服务器功能」一节。5. WindsurfWindsurf是另一款支持 MCP 的 AI 代码编辑器。安装从 Windsurf 官网codeium.com/windsurf下载并安装创建账号并登录。配置Windsurf 通过设置界面管理配置打开设置Ctrl, / Cmd,搜索「MCP」点击「Edit in settings.json」编辑配置文件。示例配置{ windsurf.mcp.servers: { my-tools: { command: python, args: [/path/to/server.py], env: {} } }, windsurf.mcp.enabled: true }windsurf.mcp.enabled是总开关置为true后上述服务器才会被加载。传输类型对比不同主机支持的传输机制不同这直接决定了你能用本地子进程服务器还是远程 HTTP 服务器主机stdioSSE/HTTPWebSocketClaude Desktop✅❌❌VS Code✅✅❌Cursor✅✅❌Cline✅✅❌Windsurf✅✅❌stdio标准输入/输出最适合由主机启动的本地服务器。主机将服务器作为子进程拉起通过 stdin/stdout 交换换行分隔的 JSON-RPC 消息服务器只能把日志写到 stderr绝不能污染 stdout这是 stdio 传输的硬性约束详见 03-GettingStarted/05-stdio-server/README.md。SSE/HTTP适合远程服务器或需要被多个客户端共享的服务器。注意当前规范中独立 SSE 传输已被弃用被Streamable HTTP取代——后者支持通知机制、更好的扩展性且被 03-GettingStarted/06-http-streaming/README.md 推荐用于生产与云端场景。常见问题与解决方案服务器无法启动先在终端手动测试服务器# Python python -m your_server_module # Node.js node /path/to/server/index.js检查命令路径尽量使用绝对路径确认可执行文件在PATH中Windows 下尤其常见。检查依赖# Python pip list | grep mcp # Node.js npm list modelcontextprotocol/sdk服务器已连接但工具不工作检查服务器日志多数主机提供日志开关如 VS Code 的mcp.enableLogging用 MCP Inspector 验证工具注册Inspector 会列出全部工具、输入模式并显示完整 JSON 响应是定位「工具未注册/参数不匹配」的利器参见 03-GettingStarted/13-mcp-inspector/README.md检查权限部分工具需要文件或网络访问权限确认主机是否授予了相应访问范围。环境变量未传递部分主机会「清洗」进程环境变量避免把宿主机全部环境泄露给服务器子进程请显式使用配置中的env字段声明需要传递的变量不要在配置文件中存放敏感信息改用密钥管理服务或环境变量间接引用。安全最佳实践无论使用哪种主机以下原则都应遵守绝不把 API 密钥提交进配置文件如 Git 仓库中的mcp.json使用环境变量或密钥管理承载敏感数据把服务器权限限制到最小必要范围如server-filesystem只授权指定目录授予系统访问权限前先审查服务器代码npx -y拉取的第三方包尤其需要留意对文件系统与网络访问使用 allowlist白名单。这些原则与本仓库 02-Security/README.md 中的安全章节一脉相承面对不可信的工具结果与服务器内容主机应用需要额外的防御纵深。深入原理主机背后的协议与验证工具理解了上述配置再看几处底层机制会有助于排查问题stdio 是「进程即传输」客户端负责以commandargs启动服务器子进程双方只在 stdin/stdout 上交换换行分隔的 JSON-RPC 消息。因此配置中的command/args/env/cwd本质上就是在定义子进程的启动方式。远程传输正在换代/sse是 MCP2025-11-25的遗留配置2026-07-28规范要求使用 Streamable HTTP并以MCP-Protocol-Version、Mcp-Method、Mcp-Name等头部描述每次自包含的请求见 01-CoreConcepts/mcp-2026-07-28.md。配置新主机时优先选择 Streamable HTTP。用 MCP Inspector 做独立验证不需要完整主机应用即可测试服务器——npx modelcontextprotocol/inspector python server.py会启动本地 Web 界面展示已注册的工具、资源、提示词以及完整的 JSON-RPC 消息流是连接主机前的「第一道质检」详见 03-GettingStarted/13-mcp-inspector/README.md。下一步3.13 - 使用 MCP Inspector 调试3.1 - 创建你的第一个 MCP 服务器模块 5 - 高级主题赞分享教程文档人工智能【免费下载链接】mcp-for-beginnersThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable, and secure AI workflows from session setup to service orchestration.项目地址https://gitcode.com/GitHub_Trending/mc/mcp-for-beginners点击查看免费下载相关推荐主流 MCP 主机客户端配置实战Claude Desktop、VS Code、Cursor、Cline 与 Windsurf 全指南主流 MCP 主机客户端配置实战Claude Desktop、VS Code、Cursor、Cline 与 Windsurf 全指南 MCP 服务器Serv教程文档人工智能MCP Hosts 实战指南在 Claude Desktop、VS Code、Cursor、Cline 与 Windsurf 中配置与使用 MCP 服务器MCP Hosts 实战指南在 Claude Desktop、VS Code、Cursor、Cline 与 Windsurf 中配置与使用 MCP 服务器 本教程文档人工智能Thorium浏览器按指令集编译的Chromium,给嫌默认版慢的人Thorium浏览器按指令集编译的Chromium,给嫌默认版慢的人 你有多久没在意过浏览器的冷启动时间了多数人把打开浏览器慢当成理所当然其实从按下图桌面应用跨平台上一篇Aspire CLI 安装路线旁车install-route sidecar机制一个 JSON 文件如何决定 CLI 的目录布局与状态位置下一篇智能图片去重革命AntiDupl.NET如何拯救你的数字存储空间创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考