在 Windows 上安装

在 Windows 上安装和配置 ContextForge MCP 的完整指南。

前提条件

Node.js 18 或更高版本
从 nodejs.org 下载。使用 LTS 版本（Windows 安装程序 .msi）
Claude Desktop 或 Claude Code
从 claude.ai/download 下载 Claude Desktop
ContextForge 账户
Create a free account

第一步：安装 ContextForge MCP

以管理员身份打开 PowerShell 或 命令提示符（建议以管理员身份运行）并执行：

npm install -g contextforge-mcp

提示：如果遇到权限错误，请右键单击 PowerShell 并选择"以管理员身份运行"

第二步：验证安装

检查安装是否成功：

# Check if contextforge-mcp is installed
where contextforge-mcp

# Should output something like:
# C:\Users\YourName\AppData\Roaming\npm\contextforge-mcp

选项 A：Claude Code（CLI）

快速配置向导

备选方案：手动命令

claude mcp add contextforge -s user -e CONTEXTFORGE_API_KEY=your-api-key-here -- npx -y contextforge-mcp

验证配置

# List configured MCPs
claude mcp list

# Or run verification
npx contextforge-setup --verify

选项 B：Claude Desktop

1. 找到配置文件

按 Win + R 并输入：

%APPDATA%\Claude

这将打开该文件夹。找到 claude_desktop_config.json。如果不存在，请创建它。

2. 配置文件完整路径

C:\Users\YOUR_USERNAME\AppData\Roaming\Claude\claude_desktop_config.json

3. 添加 ContextForge 配置

用记事本或 VS Code 编辑该文件，添加以下内容：

{
  "mcpServers": {
    "contextforge": {
      "command": "npx",
      "args": ["-y", "contextforge-mcp"],
      "env": {
        "CONTEXTFORGE_API_KEY": "your-api-key-here"
      }
    }
  }
}

注意：将 your-api-key-here 替换为你从仪表盘获取的实际 API key

4. 重启 Claude Desktop

完全关闭 Claude Desktop（检查系统托盘）后重新打开。

更新 ContextForge MCP

有新版本时，可以通过以下命令更新：

npm install -g contextforge-mcp

如果遇到问题或需要全新重装：

npm uninstall -g contextforge-mcp && npm install -g contextforge-mcp

更新后，请重启 Claude Desktop 或 Claude Code 会话以使更改生效。

Windows 故障排除

'contextforge-mcp' 无法识别

通常意味着 npm 全局 bin 文件夹不在 PATH 中。

# Find npm global folder
npm config get prefix

# Add to PATH (PowerShell as Admin)
$env:Path += ";C:\Users\YOUR_USERNAME\AppData\Roaming\npm"

# Or add permanently via System Properties > Environment Variables

权限被拒绝错误

以管理员身份运行 PowerShell：右键单击 PowerShell → "以管理员身份运行"

未找到 Node.js

安装 Node.js 后，重启终端。如果仍无法识别：

# Verify Node installation
node --version
npm --version

配置文件未加载

确保 JSON 格式有效（无尾随逗号，引号正确）。使用 JSON 验证工具或 VS Code 检查语法。

Claude Desktop 未显示 ContextForge

确保已完全关闭 Claude Desktop（检查时钟附近的系统托盘图标）。然后重新打开。