🚧 网站正在建设中，部分内容由 AI 生成，如有错误，请见谅 🚧
01MVP Logo01MVP
MCP指南/MCP使用指南

MCP平台使用指南

在不同平台上使用MCP的详细教程，包括Claude桌面应用、Cursor IDE、VSCode等

返回MCP使用指南主页

本文详细介绍如何在各个支持MCP的平台上配置和使用MCP，以最大化AI助手的能力。

1. Claude桌面应用

Claude桌面应用是Anthropic官方提供的客户端应用，也是使用MCP最直接的方式。

1.1 安装与设置

  1. 下载与安装

    • 从Claude官方网站下载最新版本
    • 根据操作系统选择对应的安装包（Windows/macOS）
    • 完成安装并登录您的Anthropic账号

  2. 配置文件位置

    • Windows: C:\Users\<用户名>\AppData\Roaming\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  3. 基本配置示例

    {
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem"],
      "resources": {
        "paths": ["/用户文档路径"]
      }
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "您的BRAVE_API密钥"
      }
    }
  }
}

1.2 使用技巧

  1. 启动服务器验证

    • 启动Claude桌面应用后，查看右侧工具图标是否可用
    • 点击工具图标，确认服务器列表是否显示您配置的服务器

  2. 常用提示语

    • 文件操作：请列出我Documents目录下的文件
    • 搜索网络：请搜索最新的AI技术新闻
    • 混合使用：请搜索最近的AI论文并在我的Documents目录创建一个摘要文件

  3. 故障排除

    • 如果工具图标灰色不可用，检查配置文件格式是否正确
    • 尝试重启Claude应用
    • 查看日志文件：~/Library/Logs/Claude/ (macOS) 或 %APPDATA%\Claude\logs\ (Windows)

2. Cursor IDE

Cursor是一个AI驱动的代码编辑器，原生集成了MCP支持。

2.1 安装与设置

  1. 下载与安装

    • 从Cursor官网下载最新版本
    • 安装并登录您的账号

  2. MCP配置文件位置

    • Windows: %APPDATA%\mcp.json
    • macOS: ~/Library/Application Support/Cursor/Cursor/mcp_config.json

  3. 基本配置示例

    {
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem"],
      "resources": {
        "paths": ["/您的项目路径"]
      }
    },
    "git": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-git"]
    }
  }
}

    window下的配置例子

    "git": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@modelcontextprotocol/server-git"]
    }

  4. 图形界面添加 图形界面添加

2.2 编程相关MCP服务器

Cursor中特别有用的MCP服务器包括：

  1. GitHub服务器

    "github": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-github"],
  "env": {
    "GITHUB_TOKEN": "您的GitHub令牌"
  }
}

  2. LLM Code Context

    "code-context": {
  "command": "npx",
  "args": ["-y", "@cyberchitta/llm-code-context"]
}

  3. Python REPL

    "python-repl": {
  "command": "python",
  "args": ["-m", "python_repl_mcp"]
}

2.3 在开发中使用

  1. 代码分析与理解

    • 提示：请分析这个项目的结构并解释主要模块的功能
    • 提示：请解释这段代码的作用并指出可能的问题

  2. 代码生成与重构

    • 提示：请根据这个规范实现一个新的功能模块
    • 提示：请重构这个函数使其更高效且可读性更强

  3. 调试与问题解决

    • 提示：这个错误是什么意思？如何修复？
    • 提示：帮我找出这个性能瓶颈并提供优化方案

3. VSCode (通过Cline)

通过Cline插件，可以在VSCode中使用MCP功能。

3.1 安装与设置

  1. 安装Cline VSCode插件

    • 在VSCode扩展市场搜索"Cline"并安装
    • 或访问Cline官网获取详细安装指南

  2. 配置MCP

    • 打开Cline设置面板（通常按Ctrl+Shift+P并搜索"Cline: Settings"）
    • 导航到"MCP服务器"部分
    • 添加您需要的MCP服务器配置

  3. 示例配置

    {
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem"],
      "resources": {
        "paths": ["${workspaceFolder}"]
      }
    }
  }
}

3.2 在VSCode中使用

  1. 启动Cline

    • 按Ctrl+Shift+L打开Cline面板
    • 或点击VSCode状态栏中的Cline图标

  2. 常用指令

    • 代码解释：请解释我选中的这段代码
    • 功能实现：请帮我实现一个能做XYZ的函数
    • 问题诊断：这段代码有什么问题？

  3. 与项目集成

    • 提示：请分析这个项目并创建一个详细的README文档
    • 提示：帮我根据这个API规范生成一套单元测试

4. Windsurf

Windsurf是一款专为开发者设计的AI编程助手，支持MCP。

4.1 安装与设置

  1. 获取Windsurf

  2. 配置MCP

    • 在Windsurf设置中找到MCP配置部分
    • 添加需要的MCP服务器配置

  3. 推荐服务器配置

    {
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem"]
    },
    "git": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-git"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "您的GitHub令牌"
      }
    }
  }
}

4.2 使用技巧

  1. 项目管理与规划

    • 提示：分析这个代码库并创建一个技术债务清单
    • 提示：帮我设计一个新功能的实现计划

  2. 代码生成与测试

    • 提示：根据这些需求生成一个组件
    • 提示：为这个函数生成单元测试

5. 框架与工具集成

5.1 微软AutoGen

AutoGen是微软开发的代理框架，支持MCP集成。

  1. 安装

    pip install pyautogen[mcp]

  2. 基本使用

    import autogen
from autogen.mcp import MCPToolkit
 
# 创建MCP工具包
mcp_toolkit = MCPToolkit()
 
# 创建使用MCP的代理
agent = autogen.AssistantAgent(
    name="agent_with_mcp",
    llm_config={"temperature": 0},
    tools=mcp_toolkit.get_tools()
)
 
# 使用代理
agent.run("分析项目目录结构并创建摘要")

5.2 HuggingFace的Smolagents

Smolagents是HuggingFace的轻量级代理框架。

  1. 安装

    pip install smolagents[mcp]

  2. 基本使用

    from smolagents import Agent
from smolagents.mcp import setup_mcp
 
# 设置MCP
mcp_tools = setup_mcp()
 
# 创建代理
agent = Agent(tools=mcp_tools)
 
# 运行代理
agent.run("搜索关于量子计算的最新研究并创建摘要")

6. 移动设备与网页版支持

6.1 Claude iOS/Android应用

目前移动端应用对MCP的支持有限：

  • iOS/Android：Claude移动应用暂不完全支持MCP功能
  • 计划中的功能：Anthropic计划在未来版本中增加移动端MCP支持

6.2 Claude网页版

Claude网页版(claude.ai)目前对MCP的支持状态：

  • 当前支持：网页版支持有限的MCP功能，主要聚焦于文件上传和基本分析
  • 未来增强：预计未来会增加更多MCP功能支持

7. 常见问题与解决方案

7.1 跨平台常见问题

  1. 配置文件格式不正确

    • 问题：服务器未启动或不可见
    • 解决：使用JSON验证工具检查配置文件格式
    • 建议：使用VSCode等支持JSON语法检查的编辑器编辑配置文件

  2. 路径问题

    • 问题：服务器无法访问指定路径
    • 解决：确保使用绝对路径，并检查权限设置
    • 示例：Windows用户使用\\或/作为路径分隔符，避免使用单反斜杠\

  3. 依赖项缺失

    • 问题：服务器启动失败，报告依赖错误
    • 解决：手动安装必要的依赖
    # Node.js依赖
npm install -g @modelcontextprotocol/server-filesystem
 
# Python依赖
pip install mcp-server-python

7.2 平台特定问题

  1. Claude桌面应用

    • 问题：应用启动后MCP图标灰色不可用
    • 解决：检查日志文件，确认是否有权限或配置错误
    • 路径：~/Library/Logs/Claude/ (macOS) 或 %APPDATA%\Claude\logs\ (Windows)

  2. Cursor IDE

    • 问题：无法使用Git/GitHub服务器
    • 解决：确保已正确配置环境变量和权限
    • 验证：尝试在终端中手动测试Git命令是否可用

  3. VSCode/Cline

    • 问题：插件无法找到MCP服务器
    • 解决：确认插件设置中的MCP配置路径是否正确
    • 建议：使用插件提供的配置向导而非手动编辑配置文件

8. 总结与最佳实践

8.1 选择合适的平台

根据您的主要使用场景选择合适的MCP平台：

  • 文档和信息处理：Claude桌面应用
  • 软件开发：Cursor IDE或VSCode+Cline
  • 自动化和代理：AutoGen或Smolagents

8.2 跨平台策略

如果您在多个平台间切换：

  1. 维护统一配置：创建一个基础MCP配置模板，在各平台适配
  2. 使用环境变量：将敏感信息（如API密钥）存储为环境变量而非硬编码
  3. 版本控制配置：将MCP配置（不含敏感信息）纳入版本控制，便于同步

8.3 性能优化

  1. 按需加载：只加载当前任务必需的MCP服务器
  2. 资源限制：对文件系统服务器设置合理的访问范围
  3. 缓存机制：对频繁访问的资源设置缓存

9. 参考资源

希望本指南能帮助您在不同平台上充分利用MCP的强大功能。随着各平台对MCP支持的不断增强，我们将持续更新本指南的内容。

Previous

MCP使用指南

Next

高德地图MCP服务集成指南

On this page