Skip to main content

Cursor 中的 MCP

intermediate 1 分钟 · 191 字 更新于： 2026-06-27 中文

把 Synapse 接入 Cursor IDE，为编码会话提供持久化的项目记忆。

阅读本文： 📄 纯文本 ⚡ JSON 🤖 LLM 格式
语言: English中文हिन्दीEspañolFrançaisالعربيةPortuguêsРусский日本語DeutschItaliano한국어NederlandsPolskiTürkçeSvenskaTiếng ViệtไทยBahasa IndonesiaУкраїнська

Cursor 中的 MCP

Cursor 是基于 VS Code 的 AI 驱动 IDE。借助 Synapse MCP，Cursor 在会话之间获得持久化记忆 — 它会记住你的项目决策、代码库模式和过往调试会话。

前置条件

配置

第 1 步：打开 Cursor 设置

在 Cursor 中：

  1. 打开设置（macOS Cmd+,，Windows/Linux Ctrl+,）
  2. 搜索 “MCP” 或导航到 Cursor Settings → MCP Servers

第 2 步：添加 Synapse MCP Server

点击 “Add MCP Server” 并配置：

字段 值
Name synapse
Type stdio
Command npx -y synapse-mcp-api@latest
Env SYNAPSE_MIND_KEY=mk_YOUR_KEY, SYNAPSE_URL=https://synapse.schaefer.zone

第 3 步：直接编辑 config.json（备选）

Cursor 把 MCP 配置存储在 ~/.cursor/config.json：

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-mcp-api@latest"],
      "env": {
        "SYNAPSE_MIND_KEY": "mk_YOUR_MIND_KEY_HERE",
        "SYNAPSE_URL": "https://synapse.schaefer.zone"
      }
    }
  }
}

第 4 步：重启 Cursor

完全重启 Cursor（macOS 上 Cmd+Q 后重新打开）。

验证可用

在 Cursor 的聊天面板中（Cmd+L）：

recall all my memories

Cursor 应调用 memory_recall 并返回你已存储的记忆。

常见模式

项目入门

打开新项目时：

recalling project context — what do I know about this codebase?

Cursor 调用 memory_recall 并从中断处继续工作。

架构决策

store this decision: "Using Fastify instead of Express for this project
because of schema validation. Date: 2026-06-27."

Cursor 把它存为 project 记忆，优先级 high。

调试历史

what bugs have I hit in this codebase?

Cursor 搜索 mistake 记忆并提醒你过往修复。

跨会话代码模式

search memories: "authentication pattern"

Cursor 找出你以前实现过的认证相关记忆。

故障排查

MCP Server 未连接

  1. 验证 Node.js：node --version（≥ 18）
  2. 测试 MCP Server：npx -y synapse-mcp-api@latest（应无错启动）
  3. 查看 Cursor 的 MCP 日志（View → Output → MCP）
  4. 完全重启 Cursor

工具未出现

  • 检查 ~/.cursor/config.json 是否为有效 JSON
  • 验证 SYNAPSE_MIND_KEY 环境变量已设置
  • 检查 Cursor 版本是否支持 MCP（≥ 0.42）

Mind Key 无效

# 直接测试你的 Mind Key
curl -H "Authorization: Bearer mk_YOUR_KEY" \
     https://synapse.schaefer.zone/memory/recall

下一步

← 返回 MCP 集成