本地部署与配置 MCP 服务器

本指南将根据您提供的专业指令，演示如何为两个不同技术栈的 MCP 服务器（一个基于 Python/uv，一个基于 Bun/TypeScript）设置项目、运行服务，并在 Cursor 中进行配置。主要针对wsl。

项目一：mcp_sequential_thinking (Python 环境)

这是一个使用 uv 作为包管理器的 Python 项目。

1. 设置项目

首先，克隆项目仓库（此处使用占位符，请替换为实际仓库地址），并创建虚拟环境。

# 克隆你的项目
git clone <your-python-mcp-repo-url>
cd <project-folder>

# 创建并激活虚拟环境
uv venv

# 激活环境
# Windows
.venv\Scripts\activate
# Unix/Linux/macOS
source .venv/bin/activate

2. 安装依赖

uv 提供了灵活的依赖安装选项。

# 仅安装核心依赖
uv pip install -e .

# (推荐开发) 安装核心及测试工具
uv pip install -e ".[dev]"

# 安装所有可选依赖
uv pip install -e ".[all]"

3. 运行服务器

您可以通过两种方式启动本地服务器。

# 方式一：直接通过模块运行
uv run -m mcp_sequential_thinking.server

# 方式二：使用安装后生成的脚本
mcp-sequential-thinking

启动后，请留意终端输出，确认服务器正在监听的 IP 地址和端口号。

4. (可选) 运行测试

确保代码质量，可以运行单元测试。

# 运行所有测试
pytest

# 运行测试并生成覆盖率报告
pytest --cov=mcp_sequential_thinking

---

项目二：context7-mcp (Bun 环境)

这是一个使用 Bun 作为运行时和工具链的 TypeScript/JavaScript 项目。

1. 设置项目

克隆 context7 的仓库并使用 bun 安装依赖。

# 克隆 context7 项目
git clone <your-bun-mcp-repo-url>
cd <project-folder>

# 安装依赖
bun i

2. 构建项目

bun 用于将 TypeScript 源代码编译为可执行的 JavaScript。

bun run build

此命令通常会在 dist 目录下生成输出文件。

3. 运行服务器

构建完成后，运行服务器并可指定参数。

# 基本运行方式
bun run dist/index.js

# 高级运行方式：指定传输协议和端口
# 下例将使用 http 协议并在 8080 端口上运行
bun run dist/index.js --transport http --port 8080

---

在 Cursor 中配置本地服务器

将本地运行的服务器接入 Cursor 有两种主要方式：

方式一：HTTP 连接 (推荐)

当您的服务器已经在本地终端中成功运行时，可以使用此方法。

1. 打开 Cursor 设置，进入 MCP 配置页。
2. 点击 “Add Server”。
3. 对于 context7-mcp (假设运行在 8080 端口):
   • Name (名称): context7-local-http
   • Type (类型): http
   • URL (地址): http://localhost:8080
4. 对于 mcp_sequential_thinking:
   • Name (名称): sequential-thinking-local-http
   • Type (类型): http
   • URL (地址): http://localhost:<YOUR_PYTHON_PORT> (请替换为 Python 服务器实际监听的端口号)

方式二：Command 命令 (由 Cursor 启动)

这种方式让 Cursor 在需要时自动执行命令来启动服务器。

1. 打开 Cursor 设置，进入 MCP 配置页。

2. 点击 “Add Server”。

3. 配置示例 (适用于 TypeScript 项目):

   • Name (名称): context7-local-cmd
   • Type (类型): command
   • Command (命令): npx tsx /path/to/folder/context7-mcp/src/index.ts

   重要提示: 您必须将 /path/to/folder/context7-mcp/src/index.ts 替换为您本地存放 context7 项目的绝对路径。这种方式更适合直接运行源文件，无需手动 build 和 run。

书写形式

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "/home/hero/mcp-sequential-thinking/.venv/bin/mcp-sequential-thinking",
      "cwd": "/home/hero/mcp-sequential-thinking"
    },
    "context7": {
      "command": "bun",
      "args": ["run", "/home/hero/context7/src/index.ts"]
    }
  }
} 

自行理解

提示词

你是一位具备顺序逻辑推理能力与跨文件代码理解能力的 AI 助手。我希望你结合 Sequential Thinking 插件的多步骤推理能力，以及 Context7 插件的跨上下文代码理解能力，帮助我更清晰、精准地完成以下任务。

请执行以下策略：
1. 拆分任务为合理的多个思维步骤，并依次处理（Sequential Thinking）。
2. 若任务涉及多个文件或函数，自动调用 Context7 插件提取和关联上下文。
3. 在必要时提供逐步思路、函数关系图、模块依赖路径，并解释推理过程。
4. 保持逻辑清晰，输出建议时标明每一步对应的推理依据。