【2025最新】Cursor MCP完全指南：5大核心功能与3种部署方案全解析

# 验证MCP功能是否正常工作
# 在Cursor的AI面板中输入以下提示：
使用MCP工具帮我在项目中搜索所有包含"function"关键词的文件

@app.route('/tools', methods=['GET'])
def get_tools():
    # 返回工具列表及其功能描述
    return jsonify(tools)

@app.route('/execute', methods=['POST'])
def execute_tool():
    # 接收工具调用请求并执行
    data = request.json
    tool_name = data.get('name')
    params = data.get('parameters', {})
    
    # 执行对应工具
    result = tools_registry[tool_name](params)
    
    # 返回结果
    return jsonify({"result": result})

# MCP工具描述示例
{
  "tools": [
    {
      "name": "search_codebase",
      "description": "搜索代码库中的文件和内容",
      "parameters": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "搜索关键词"
          },
          "file_types": {
            "type": "array",
            "items": {"type": "string"},
            "description": "要搜索的文件类型，如['.js', '.py']"
          },
          "max_results": {
            "type": "integer",
            "description": "最大结果数量"
          }
        },
        "required": ["query"]
      }
    }
  ]
}

# app.py
from flask import Flask, request, jsonify
import json
import subprocess

app = Flask(__name__)

TOOLS = [
    {
        "name": "analyze_dependencies",
        "description": "分析项目依赖并提供信息",
        "parameters": {
            "type": "object",
            "properties": {
                "project_path": {
                    "type": "string",
                    "description": "项目路径"
                },
                "scan_vulnerabilities": {
                    "type": "boolean",
                    "description": "是否扫描安全漏洞"
                }
            },
            "required": ["project_path"]
        }
    }
]

@app.route('/tools', methods=['GET'])
def get_tools():
    return jsonify(TOOLS)

@app.route('/execute', methods=['POST'])
def execute_tool():
    data = request.json
    tool_name = data.get('name')
    params = data.get('parameters', {})
    
    if tool_name == "analyze_dependencies":
        return jsonify({"result": analyze_dependencies(params)})
    else:
        return jsonify({"error": "Tool not found"}), 404

def analyze_dependencies(params):
    project_path = params.get('project_path')
    scan_vulnerabilities = params.get('scan_vulnerabilities', False)
    
    # 检查package.json
    result = {"dependencies": [], "dev_dependencies": []}
    
    try:
        # 读取package.json
        with open(f"{project_path}/package.json", "r") as f:
            package_data = json.load(f)
            
        if "dependencies" in package_data:
            result["dependencies"] = [{
                "name": dep,
                "version": version
            } for dep, version in package_data["dependencies"].items()]
            
        if "devDependencies" in package_data:
            result["dev_dependencies"] = [{
                "name": dep,
                "version": version
            } for dep, version in package_data["devDependencies"].items()]
        
        # 扫描漏洞
        if scan_vulnerabilities:
            try:
                output = subprocess.check_output(
                    ["npm", "audit", "--json"],
                    cwd=project_path
                )
                audit_data = json.loads(output)
                result["vulnerabilities"] = audit_data.get("vulnerabilities", {})
            except Exception as e:
                result["vulnerabilities_error"] = str(e)
    
    except Exception as e:
        return {"error": str(e)}
    
    return result

if __name__ == '__main__':
    app.run(port=5000)

# Cursor配置文件示例
{
  "ai": {
    "provider": "custom",
    "model": "gpt-4",
    "apiEndpoint": "https://api.laozhang.ai/v1",
    "apiKey": "您的laozhang.ai API密钥"
  },
  "mcp": {
    "enabled": true,
    "servers": [
      {
        "name": "laozhang MCP",
        "url": "https://api.laozhang.ai/mcp",
        "apiKey": "您的laozhang.ai API密钥"
      }
    ]
  }
}

# Python示例：使用laozhang.ai API
import requests

api_key = "YOUR_API_KEY"
url = "https://api.laozhang.ai/v1/chat/completions"

payload = {
    "model": "gpt-4",
    "messages": [
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "请帮我分析这段代码的问题"}
    ],
    "stream": True
}

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {api_key}"
}

response = requests.post(url, json=payload, headers=headers, stream=True)

for line in response.iter_lines():
    if line:
        print(line.decode('utf-8'))