光标-MCP服务器-0.46-windows命令测试

Name: 光标-MCP服务器-0.46-windows命令测试
Author: Zanedname

作者：Zanedname5 星标更新：2025-03-13

安装使用来源：spider==github.com

项目介绍

Cursor MCP Servers 0.46 Windows 配置指南

这全部是在Cursor中完成的，从创建仓库到生成文件，再到配置整个README，直到上传和更新仓库，所有操作都在Cursor中通过自然语言实现。（仓库中的部分内容可能存在问题，因此不要完全信任它）

简介

本仓库提供了一个详细的指南，用于在Windows环境下配置和使用Cursor IDE版本0.46中的MCP（模型上下文协议）服务器功能。MCP允许AI助手使用外部工具和服务，大大扩展了它们的功能性和实用性。

什么是MCP？

MCP（模型上下文协议）是一种允许大型语言模型（LLMs）与外部工具和服务进行交互的协议。在Cursor IDE中，MCP服务器功能允许AI助手调用各种工具来执行诸如搜索、浏览网页和执行代码等操作。

前提条件

在开始配置MCP服务器之前，请确保满足以下条件：

Cursor IDE版本0.46或更高版本
Windows 10/11操作系统
Node.js v18或更高版本
基础命令行知识
对于特定的MCP服务器可能需要的API密钥

安装方法

方法1：通过Cursor界面设置

这是最简单的方法，适合初学者：

打开Cursor IDE
点击左下角的设置图标（⚙️）
导航到“功能”部分
滚动到“MCP服务器”部分
点击“添加新MCP服务器”
选择‘Stdio/local’作为连接类型
输入服务器命令（参见常用MCP服务器部分）
点击“添加”以保存配置

Cursor设置界面

方法2：使用项目级配置文件

注意在Windows环境中，Cursor 0.46版本的项目级配置文件功能可能会有问题。如果此方法不起作用，请使用方法1或方法3。

为特定项目配置MCP服务器：

在项目的根目录中创建.cursor文件夹（如果不存在）
在.cursor文件夹中创建mcp.json文档
使用以下格式配置MCP服务器：

{
  "mcpServers": {
    "server_name": {
      "command": "command_executable",
      "args": ["arg1", "arg2", "..."]
    }
  }
}

例如，配置Sequential Thinking服务器：

{
  "mcpServers": {
    "sequential_thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    }
  }
}

方法3：使用全局配置文件

注意全局配置文件功能可能需要特定版本的Cursor支持。

为所有项目配置MCP服务器：

导航到Cursor的配置目录（通常位于%APPDATA%\Cursor）
创建或编辑mcp.json文档
使用与项目级配置相同的格式

常用MCP服务器

这里是一些常用的MCP服务器及其配置命令：

Sequential Thinking

npx -y @modelcontextprotocol/server-sequential-thinking

Brave Search

env BRAVE_API_KEY=[your-key] npx -y @modelcontextprotocol/server-brave-search

Puppet (web浏览)

npx -y @modelcontextprotocol/server-puppeteer

GitHub 工具

npx -y @modelcontextprotocol/server-github

文件系统工具

npx -y @modelcontextprotocol/server-fs

环境变量配置

一些MCP服务器需要环境变量来配置API密钥或其他设置。在Windows中，有几种方法可以设置环境变量：

方法1：直接在命令中设置

env API_KEY=your_key_here npx -y @package/server-name

方法2：使用PowerShell设置临时环境变量

$env:API_KEY="your_key_here"
npx -y @package/server-name

方法3：使用系统环境变量

右键点击“我的电脑”，选择“属性”
点击“高级系统设置”
点击“环境变量”
在“用户变量”部分添加一个新变量

故障排除

常见问题及解决方案

MCP服务器状态显示黄色
- 尝试刷新服务器状态
- 检查命令是否正确
- 重启Cursor IDE
无法找到MCP工具
- 确保在Composer或Agent模式下使用
- 明确指示AI使用MCP工具
- 检查服务器状态是否为绿色
Windows权限问题
- 尝试以管理员身份运行终端
- 检查防火墙设置
- 确保Node.js具有足够的权限
项目级配置文件不起作用
- 这是Windows环境下的已知问题
- 尝试使用全局配置文件或通过设置界面添加
Node.js版本问题
- 使用nvm切换到Node.js v18或更高版本：
```
nvm install 18
nvm use 18
```

最佳实践

按需添加服务器
- 只添加当前任务所需的MCP服务器
- 过多的服务器可能会增加令牌消耗
使用Git Bash而不是CMD
- Windows用户可能会发现Git Bash比CMD更适合运行某些MCP服务器
安全存储API密钥
- 不要在共享代码中硬编码API密钥
- 使用环境变量或安全密钥管理解决方案
定期更新MCP服务器
- MCP生态系统正在快速发展，建议定期检查和更新
项目特定配置
- 为不同的项目使用不同的MCP服务器配置
- 考虑使用项目级配置文件（如果支持）

常见问题

MCP是否只在特定模式下工作？

是的，MCP工具仅在Composer和Agent模式下可用。

如何知道MCP服务器是否正常工作？

服务器状态指示器应显示为绿色，并且在使用时会弹出终端窗口。

同时可以使用多少个MCP服务器？

理论上没有限制，但建议只添加当前需要的服务器以减少资源消耗。

如何在多台计算机之间共享MCP配置？

可以将.cursor/mcp.json文件添加到版本控制系统中，或者使用配置同步工具。